Node.js中fs.readdir读取含特殊字符文件失效问题求助

我之前在Alpine环境下用Node.js处理带特殊字符的文件名时，也碰到过几乎一模一样的乱码问题——就是那种带重音符号的字符变成í这类奇怪的组合，本质是Alpine的musl libc和Node.js 8的编码处理逻辑不兼容导致的，给你几个亲测有效的解决办法：

1. 调用fs.readdir时显式指定UTF-8编码 #

Node.js 8的fs.readdir其实支持直接指定编码，只是有些老文档没强调这点。你可以在调用时明确传入utf8编码参数，强制让Node用UTF-8解析文件名：

异步版本 #

const fs = require('fs');

fs.readdir('./目标目录路径', { encoding: 'utf8' }, (err, files) => {
  if (err) throw err;
  console.log('解析后的文件名：', files);
});

同步版本 #

const fs = require('fs');

const files = fs.readdirSync('./目标目录路径', 'utf8');
console.log('解析后的文件名：', files);

2. 修复Alpine系统的Locale设置 #

Alpine Linux默认没有预装完整的locale包，系统默认字符集可能不是UTF-8，这会影响Node.js读取文件系统的字符编码。你需要先安装locale包并设置UTF-8环境变量：

临时生效（容器内执行） #

# 安装locale相关包
apk add --no-cache musl-locales musl-locales-lang
# 设置UTF-8 locale
export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8

永久生效（Dockerfile配置） #

如果是用Docker部署的node8-alpine镜像，把这些配置加到Dockerfile里：

FROM node:8-alpine

# 安装locale包并设置UTF-8环境变量
RUN apk add --no-cache musl-locales musl-locales-lang
ENV LANG=en_US.UTF-8
ENV LC_ALL=en_US.UTF-8

# 后续的镜像构建步骤...

3. 手动用Buffer转码兜底 #

如果上面两种方法都没解决，你可以先读取文件名的原始Buffer，再手动转成UTF-8，这种方式能绕过系统默认编码的干扰：

const fs = require('fs');

fs.readdir('./目标目录路径', { encoding: 'buffer' }, (err, fileBuffers) => {
  if (err) throw err;
  // 将每个Buffer转成UTF-8字符串
  const decodedFiles = fileBuffers.map(buf => buf.toString('utf8'));
  console.log('转码后的文件名：', decodedFiles);
});

额外建议 #

Node.js 8确实是比较老旧的版本了，后续版本（比如Node 12及以上）对文件系统的编码处理做了很多优化，尤其是在Alpine这类musl libc环境下的兼容性提升明显。如果业务允许的话，升级Node版本能从根本上减少这类编码问题。

内容的提问来源于stack exchange，提问作者saeta