debian js日志编码异常

在 Debian 上遇到 JS 日志编码异常（比如中文变成乱码、问号、十六进制 \uXXXX、或终端显示异常），通常和 locale、文件编码、终端、Node/浏览器输出方式 有关。下面按常见场景给你排查与解决办法。

一、先确认现象

请先明确是哪一种：

1. 终端直接运行 Node 脚本，日志乱码
2. 日志写入文件后是乱码
3. 浏览器前端 JS 日志乱码
4. Docker / systemd 服务中 JS 日志乱码
5. 日志里中文变成 \u4e2d\u6587

二、Debian 系统 locale 问题（最常见）

1. 查看当前 locale

locale

如果看到：

LANG=
LC_ALL=

或

C

就容易出现编码问题。

2. 生成 UTF-8 locale

sudo apt update
sudo apt install locales
sudo dpkg-reconfigure locales

勾选：

en_US.UTF-8
zh_CN.UTF-8

设置默认：

sudo update-locale LANG=en_US.UTF-8

重启或重登录后确认：

echo $LANG
# 应为 en_US.UTF-8 或 zh_CN.UTF-8

三、Node.js 日志乱码

1. Node 默认编码

Node 控制台输出依赖：

• 系统 locale
• 终端编码

确保：

node -e "console.log('中文测试')"

正常显示。

2. 文件写入乱码

错误方式：

fs.writeFileSync('log.txt', '中文')

推荐：

fs.writeFileSync('log.txt', '中文', 'utf8')

或：

const fs = require('fs')
fs.writeFile('log.txt', '中文', { encoding: 'utf8' }, () => {})

3. 读取日志文件乱码

fs.readFile('log.txt', 'utf8', (err, data) => {
  console.log(data)
})

四、终端 / SSH 客户端编码

如果你用：

• PuTTY
• Xshell
• SecureCRT

请确认：

• 字符编码：UTF-8
• 不要选 GBK

五、systemd 服务中 JS 日志乱码

systemd 默认环境可能 没有 locale。

解决

sudo systemctl edit your-js-service

加入：

[Service]
Environment=LANG=en_US.UTF-8
Environment=LC_ALL=en_US.UTF-8

重载：

sudo systemctl daemon-reload
sudo systemctl restart your-js-service

六、Docker 中 JS 日志乱码

Dockerfile

ENV LANG=C.UTF-8
ENV LC_ALL=C.UTF-8

docker run

docker run -e LANG=C.UTF-8 -e LC_ALL=C.UTF-8 your-image

七、日志里出现 \u4e2d\u6587

这是 JSON 转义，不是乱码。

例如：

console.log(JSON.stringify({ msg: '中文' }))

解决：

console.log(JSON.stringify({ msg: '中文' }, null, 2))

或

console.log('中文')

八、快速自检清单 ✅

• [ ] locale 是 UTF-8
• [ ] 终端编码是 UTF-8
• [ ] Node 写文件指定 utf8
• [ ] systemd / Docker 设置 LANG
• [ ] 日志不是 JSON 转义误解

如果你愿意，可以把：

• 日志截图 / 示例
• Node 版本
• 运行方式（终端 / systemd / docker） 发出来，我可以直接帮你定位到具体原因。