debian nodejs日志为何乱码

Debian 上 Node.js 日志出现乱码，通常不是 Node.js 本身的问题，而是字符编码 / 终端环境不一致导致的。下面按常见原因和解决办法说明。

一、最常见原因：终端编码不是 UTF-8

现象

• console.log('中文') 乱码
• 日志文件用 cat 看乱码，但用编辑器正常

原因

Debian 默认可能是：

LANG=C
LC_ALL=C

C locale 不支持 UTF-8。

解决

查看当前 locale：

locale

如果不是 UTF-8，设置：

sudo apt install locales
sudo dpkg-reconfigure locales
# 选择 zh_CN.UTF-8 或 en_US.UTF-8

或临时生效：

export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8

二、Node.js 输出编码与终端不一致

Node.js 默认使用 UTF-8，但如果：

• 终端是 GBK
• 或者 SSH 客户端编码设置错误

就会乱码。

解决

• 确保终端（Xshell / Terminal / VS Code）编码为 UTF-8
• 不要使用 GBK 终端

三、日志重定向到文件后乱码

原因

• 文件本身是 UTF-8
• 但查看工具（如 Windows 记事本）用 GBK 打开

解决

用 UTF-8 工具查看：

less log.txt
vim log.txt

或转换：

iconv -f UTF-8 -t GBK log.txt > log_gbk.txt

四、PM2 / 服务方式运行导致乱码

原因

• systemd 环境没有 UTF-8 locale
• PM2 子进程继承错误编码

解决（systemd）

编辑：

sudo vim /etc/systemd/system/your-app.service

加：

Environment=LANG=en_US.UTF-8
Environment=LC_ALL=en_US.UTF-8

然后：

sudo systemctl daemon-reload
sudo systemctl restart your-app

五、代码中强制错误编码（少见）

错误示例：

fs.writeFileSync('log.txt', str, 'gbk');

Node.js 原生 不支持 gbk 写文件，需用 iconv-lite。

六、快速自检清单 ✅

• [ ] locale 是 UTF-8
• [ ] 终端编码是 UTF-8
• [ ] 日志文件是 UTF-8
• [ ] PM2 / systemd 设置了 UTF-8
• [ ] 没手动转码成 GBK

如果你愿意，可以贴：

• 乱码截图或示例
• locale 输出
• 运行方式（node / pm2 / docker / systemd）

我可以更精准帮你定位。