VSCode中npm scripts输出中文乱码的根本原因是Node进程默认继承Windows GBK代码页(936),将UTF-8字节流误按GBK解码;解决需三步:配置terminal.integrated.profiles.windows让PowerShell启动即执行chcp 65001,settings.json中设置terminal.integrated.env.windows添加"PYTHONIOENCODING": "utf8",并在package.json scripts中使用cross-env统一设置NODE_OPTIONS=--no-warnings。

VSCode里跑 npm scripts 输出中文乱码,不是代码写错了,而是 Node 进程启动时没按 UTF-8 解码字节流——终端本身能显示中文,但 node 和 npm 子进程默认继承了 Windows 的 GBK 代码页(936),和你文件里保存的 UTF-8 中文对不上。
为什么 npm run dev 一输出中文就变“浣犲ソ”
根本原因在 Node.js 启动行为:Windows 下 Node 默认调用 GetConsoleOutputCP() 获取系统代码页(通常是 936),于是把 process.stdout 编码设成 cp936,而你的 JS 文件、console.log 字符串实际是 UTF-8 编码。Node 把 UTF-8 字节当 GBK 去 decode,结果自然错位。
- 验证方式:在终端运行
node -e "console.log(process.stdout.encoding)",输出cp936就是它 -
chcp 65001只改终端显示层,不改 Node 进程内部编码 - 哪怕 VSCode 编辑器里中文注释正常,
npm scripts输出仍会乱——这是两个独立环节
给 Node 进程强制指定 UTF-8 输出编码
最稳的解法是让 Node 启动时跳过代码页探测,直接用 UTF-8 处理 stdout/stderr。Windows 上只需加一个环境变量:
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1),免gas,支持macOS/Linux/Windows。触发词:/r
- 打开 VSCode
settings.json(Ctrl+Shift+P → “Preferences: Open Settings (JSON)”) - 添加这段配置:
"terminal.integrated.env.windows": { "NODE_OPTIONS": "--no-warnings --experimental-strip-ansi", "NPM_CONFIG_LOGLEVEL": "warn", "PYTHONIOENCODING": "utf8" } - 关键项是
"NODE_OPTIONS": "--no-warnings --experimental-strip-ansi"不够,真正起作用的是"NODE_OPTIONS": "--experimental-strip-ansi"加上"NODE_OPTIONS": "--max-old-space-size=4096"并不能解决编码问题;必须显式加--experimental-strip-ansi并配合NODE_OPTIONS设置编码 - 更准确的做法:在
settings.json中加入:"terminal.integrated.env.windows": { "NODE_OPTIONS": "--no-warnings", "NPM_CONFIG_LOGLEVEL": "warn", "PYTHONIOENCODING": "utf8" }然后在package.json的 scripts 里,把"dev": "node index.js"改成"dev": "set NODE_OPTIONS=--no-warnings && node index.js"——但这个写法只适用于 CMD,PowerShell 不认set - 正确做法:统一用
cross-env,安装npm install --save-dev cross-env,然后改 script:"dev": "cross-env NODE_OPTIONS=--no-warnings node index.js"
PowerShell 终端启动即乱码?先切代码页再启 Node
如果你用的是 PowerShell 作为默认终端,它每次新开都回退到代码页 936,导致 npm 启动前环境就不干净。不能靠每次手动输 chcp 65001,得让它自动生效:
- 在
settings.json中配置 PowerShell 启动参数:"terminal.integrated.profiles.windows": { "PowerShell": { "source": "PowerShell", "args": ["-NoExit", "-Command", "chcp 65001 > $null"] } } -
-NoExit必须带上,否则终端启动后立刻关闭 - 该配置只影响 PowerShell 终端,不影响 CMD 或 Git Bash;若你切了其他终端,需对应修改 profile
- 改完重启 VSCode,新开集成终端运行
chcp应输出活动代码页: 65001
别碰 files.encoding 和字体设置来治 npm 输出乱码
很多人试过改 "files.encoding": "utf8"、换 editor.fontFamily、甚至重装中文字体,发现 npm run build 输出还是“??”——因为这些只管编辑器读写文件和 UI 渲染,完全不干预 Node 进程的 stdout 编码逻辑。
-
files.encoding控制的是你打开/保存文件时的编解码行为,和终端输出无关 - 字体设置只影响编辑器内文字渲染,不影响终端里
node打印的字节流如何被解释 - 注册表改
FontSubstitutes、系统区域设“中文(简体,中国)”——这些对npm scripts输出无效 - 真正要盯住的只有三个点:终端代码页、Node 进程启动时的
NODE_OPTIONS、以及npm自身是否受环境变量影响
最易忽略的其实是 cross-env 的使用场景:它不只是为了跨平台兼容,更是绕过 Windows CMD/Powershell 对环境变量赋值语法的限制。不用它,你在 package.json 里写的 NODE_OPTIONS=--no-warnings node xxx 在 PowerShell 下根本不会生效——这点不试一遍很难意识到。

















