node.js 读取 gbk 文件乱码的根源是默认按 utf-8 解析，而原生不支持 gbk（16+ 版本起才支持）；正确做法是显式指定 encoding: 'gbk' 或用 iconv-lite 转码 buffer。
Node.js 读取文件时中文变 或 \u4f60\u597d，先确认 fs.readFile 的 encoding 参数
Node.js 默认以 utf8 解码二进制内容，但若文件实际是 gbk（如 Windows 记事本保存的 .txt），fs.readFile(path, callback) 不传 encoding 就会返回 Buffer；而误用 toString() 无参调用，等价于 toString('utf8')，必然乱码。
正确做法是显式指定编码：
- 已知文件是 GBK：用
fs.readFile(path, 'gbk', callback)—— Node.js 16+ 原生支持gbk、gb2312等常见中文编码 - 不确定编码：先读成
Buffer，再用iconv-lite尝试转换，例如：iconv.decode(buf, 'gbk') - 避免用
fs.readFileSync(path).toString()：没指定编码就默认 utf8，极易踩坑
VSCode 编辑器显示正常，但 Node 运行时报错或输出乱码，问题不在编辑器
VSCode 右下角显示 UTF-8 且中文可读，只说明它“用 UTF-8 成功解码了该文件”；但 Node 进程是否也用 UTF-8 读取，取决于你代码里怎么调 fs.readFile 或 require。两者完全独立。
常见误判场景：
-
require('./config.json')加载含中文的 JSON 文件 → 若文件存为 GBK，Node 会因 UTF-8 解析失败直接抛SyntaxError: Unexpected token -
console.log(fs.readFileSync('readme.txt', 'utf8'))→ 文件实为 GBK，输出一堆 - 用
child_process.exec跑 Python 脚本，Python 输出中文 → 终端代码页（chcp）和stdio编码不匹配，和 VSCode 设置无关
require() 加载 .js 文件时中文注释/字符串乱码，基本是文件保存编码错了
require() 强制使用 UTF-8 解析 JS 源码，这是 V8 引擎规范。哪怕 VSCode 显示正常，只要文件实际字节不是 UTF-8，运行时就会出问题。
典型现象：
Zenlink - Node SDK for ZenHeart
下载
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
- 注释里的中文变成
\u4f60\u597d或直接报错Invalid or unexpected token - 字符串字面量
'你好'在调试器里显示为'' - 右下角状态栏显示
GBK或UTF-8 with BOM→ 这就是根源
修复动作必须落在文件本身：
- 点击右下角编码 →
Save with Encoding→ 选UTF-8（不是UTF-8 with BOM） - 确认保存后右下角显示纯
UTF-8，且重新require不再报错 - 旧项目批量转码可用
iconv-lite+fs.promises.writeFile脚本，但务必先备份
Node 子进程（如 exec Python）输出中文乱码，要调终端层而非 VSCode
在 VSCode 集成终端里跑 node app.js，里面用 exec('python script.py') 输出中文却显示方块——这不是 fs 或文件编码问题，而是子进程 stdout 的编码与当前终端代码页不一致。
Windows 下必须同步两件事：
- 终端当前代码页：执行
chcp 65001切到 UTF-8（临时生效） - 子进程环境变量：启动时加
{ env: { ...process.env, PYTHONIOENCODING: 'utf8' } } - Python 脚本内显式设
sys.stdout.reconfigure(encoding='utf-8')（Python 3.7+）
注意：files.encoding 或 autoGuessEncoding 对此零影响，改了也没用。
真正麻烦的是混合场景：文件用 GBK 保存、Node 用 utf8 读、子进程又依赖系统代码页——这种时候别指望一个设置全局生效，得一层层拆开验证 buffer 内容、encoding 参数、终端 chcp 值，缺一不可。
