VSCode中cmd.exe终端中文乱码需三步解决:1.配置terminal.integrated.profiles.windows使cmd启动时执行chcp 65001;2.设置terminal.integrated.env.windows添加PYTHONIOENCODING=utf-8;3.在terminal.integrated.fontFamily中按序指定含中文字形的等宽字体链。

cmd.exe 启动时自动执行 chcp 65001
VSCode 终端里 cmd.exe 显示中文为 □ 或问号,根本不是字体或 files.encoding 设置的问题,而是 cmd.exe 默认用 CP936(GBK)代码页启动,但 Python/Node 等工具按 UTF-8 输出字节流,两边解码规则不一致。
临时输 chcp 65001 能立刻见效,但每次新开终端都要重输——这不是工作流,是漏配。
- 必须在 VSCode 的终端配置中,让
cmd.exe每次启动时就带参数执行chcp 65001 - 打开设置(
Ctrl + ,),搜索terminal.integrated.profiles.windows,点击「在 settings.json 中编辑」 - 添加或修改
Command Prompt配置块,确保args包含"/k"和"chcp 65001",例如:
"Command Prompt": {
"path": "cmd.exe",
"args": ["/k", "chcp", "65001"]
}
/k 表示执行完命令后保持窗口打开;/c 会直接退出,不能用。
改完保存,**必须关闭所有已打开的终端页签**,再按 Ctrl + Shift + ` 新开一个——旧进程不会重新读取配置,也不会刷新代码页。
验证 chcp 是否真正生效
很多人改完配置以为万事大吉,结果 python -c "print('你好')" 还是乱码。问题往往出在没验证底层是否真用了 UTF-8。
新开终端后,第一件事不是跑脚本,而是运行:
-
chcp—— 输出应为活动代码页: 65001,不是936或其他数字 -
echo %PYTHONIOENCODING%—— 若为空,建议顺手加进环境变量(见下一条)
如果 chcp 返回不是 65001,说明配置没加载成功,检查 JSON 格式是否合法、是否拼错 profiles.windows 层级、是否误加了多余逗号。
注意:terminal.integrated.defaultEncoding 这个设置对 cmd.exe 完全无效,它只影响某些 shell 的内部逻辑,别在这上面浪费时间。
配合 PYTHONIOENCODING 防止 Python 缓存旧编码
即使 chcp 65001 生效了,Python 有时仍会把 sys.stdout.encoding 记成 cp936,尤其在 VSCode 终端复用进程时。这是因为 Python 启动时读取的是父进程(cmd.exe)初始状态,不是动态感知代码页变化。
- 在
terminal.integrated.env.windows中加入环境变量,强制 Python 使用 UTF-8:
"terminal.integrated.env.windows": {
"PYTHONIOENCODING": "utf-8"
}
这个变量比 chcp 更底层:它让 Python 解释器从启动那一刻起,就认为标准输出是 UTF-8,不再依赖终端当前代码页。
如果你还用 Node.js,可以一并加上 NODE_OPTIONS:"NODE_OPTIONS": "--no-warnings"(非必需),但核心是 PYTHONIOENCODING。
别写成 utf8(少横杠),也别设 PYTHONUTF8=1 单独存在——它需要和 PYTHONIOENCODING 配合才稳定,单独用在 cmd 下效果打折。
字体链必须显式包含中文字体,且顺序关键
编码全对,chcp 正常,PYTHONIOENCODING 也设了,但中文还是显示为方块?那是字体 fallback 失败了。
Consolas、Fira Code 这些主流等宽字体本身不含中文字形,VSCode 会尝试 fallback 到系统字体,但 Windows 下 fallback 行为极不稳定,尤其开了连字(fontLigatures)后大概率中断。
- 在设置中搜索
terminal.integrated.fontFamily,填入带单引号、逗号+空格分隔的字体链,例如:
'Cascadia Code', 'Microsoft YaHei Mono', 'SimSun', 'Consolas'
关键点:
- 中文字体名必须用全称:
Microsoft YaHei Mono不是微软雅黑,也不是Microsoft YaHei(非等宽,混排会错位) - 中文字体要放在英文之后、通用等宽字体之前,否则英文渲染会被降级
- 改完必须关掉所有终端页签重开,仅刷新窗口或点「+」新建不会更新字体缓存
Windows 10/11 自带 Cascadia Code,它原生支持中文字形且是等宽设计,比硬塞 SimSun 更可靠;若没有,Microsoft YaHei Mono 是最稳的兜底选择。











