解决VSCode终端运行代码乱码 - 编码设置终极方案

在VSCode里写Python或Node.js，文件里中文显示得好好的，一运行print("你好")，终端直接吐出一堆方框或问号——这种“文件正常，输出乱掉”的诡异局面，十有八九不是文件编码的问题，而是终端渲染层出了岔子。根本原因很简单：Windows终端默认用GBK（代码页936）去解码，而Python、Node这些工具链却按UTF-8往外吐字节。两边没对上暗号，自然就糊了。

验证起来也方便：在终端敲个chcp，如果它返回“活动代码页: 936”，那基本就坐实了。临时跑一下chcp 65001，乱码立刻变正常，更加印证了这一点。

终端输出中文是方块或问号，不是文件编码问题

这件事最容易被误解的地方在于：很多人一头扎进去改files.encoding，但那是编辑器读文件时的设置，管的是编辑器里显示中文，跟程序运行时stdout输出根本是两码事。真正要盯住的，是“程序输出 → 终端渲染”这条链路。

• 别碰files.encoding去“治”终端乱码，那属于南辕北辙
• 以前有人提terminal.integrated.encoding，但这个设置早就被废弃了，设了也没效果
• 字体选错（比如只用了Consolas，没带中文字体）也会导致方块，但那是另一层问题——先确认编码通路，别一上来就换字体

PowerShell终端必须同时设代码页和输出编码

很多人只改了chcp 65001，以为万事大吉。其实不够——PowerShell自身的[Console]::OutputEncoding如果还卡在GBK上，它启动的Python子进程收到的环境信号还是错的，输出照样乱。必须双管齐下。

• 在settings.json里配置terminal.integrated.profiles.windows，让新终端启动时自动执行chcp 65001
• 在PowerShell的$PROFILE文件里写一行[Console]::OutputEncoding = [System.Text.Encoding]::UTF8，否则用python -c "import sys; print(sys.stdout.encoding)"检查，大概率还是cp936
• 不要直接用-Command "chcp 65001; ..."，记得加上-NoExit，否则终端一闪就关，根本看不到效果

Python输出乱码要靠PYTHONIOENCODING环境变量

就算终端代码页和字体都调对了，print()还是糊——这种时候，问题通常出在Python解释器启动时读了系统代码页，把sys.stdout.encoding设成了cp936。得靠环境变量强制覆盖。

• 在settings.json里加"terminal.integrated.env.windows": {"PYTHONIOENCODING": "utf8"}（注意用小写utf8，大写UTF-8在Windows下行不通）
• 如果用了Code Runner插件，还要改它的执行命令——在code-runner.executorMap里把python对应的值改成"chcp 65001 && python -u"
• 调试器（Debug Console）不继承终端的环境变量，需要在.vscode/launch.json的env字段里单独加上{"PYTHONIOENCODING": "utf8"}

字体和系统区域设置是最后两道防线

编码全部调对了，出来的还是方块？那说明终端渲染层可能卡在了字体上。Windows这边，常见的原因是字体链里没兜住中文字形，或者系统级locale没启用UTF-8。

• 在settings.json里设"terminal.integrated.fontFamily": "Sarasa Gothic SC, Consolas, 'Courier New'"（注意用等宽字体，Microsoft YaHei不是等宽，慎用）
• 右键终端标题栏 → 属性 → 字体，手动选一个支持CJK的等宽字体，改完记得新开终端
• 系统级方案：控制面板 → 区域 → 管理 → 更改系统区域设置 → 勾选Beta 版：使用 Unicode UTF-8 提供全球语言支持，重启后生效。这个改动会影响所有命令行工具（包括Git Bash、WSL），是最彻底的解法，但副作用也大一些，需要谨慎评估

终端乱码不是单点故障，而是编码、环境变量、字体、系统设置四层叠加的结果。最容易翻车的地方恰恰是PowerShell的[Console]::OutputEncoding和Python的PYTHONIOENCODING必须同时存在，缺一不可。按这个顺序排查下来，基本不会再被乱码折腾。