vscode中文乱码需先区分output面板、集成终端或编辑器三处位置:output乱码应配置code runner的executormap并设pythonioencoding;终端乱码需在profiles.windows中为powershell注入chcp 65001和环境变量;编辑器乱码则需右下角重新编码打开并另存为utf-8。

VSCode 运行程序中文乱码,90% 不是文件编码错了,而是输出链路中某一层解码逻辑没对齐——你改了 files.encoding 却没动 PYTHONIOENCODING 或 terminal.integrated.profiles.windows,就注定白调。
确认乱码发生在 Output 面板还是集成终端(Terminal)
这是必须最先做的判断,否则所有配置都可能打偏:
- 如果编辑器里代码显示正常,但点击 Code Runner 的 ▶️ 按钮后,底部「OUTPUT」标签页里中文是乱码 → 问题在 Code Runner 的输出解码逻辑,和系统
chcp完全无关 - 如果是在「TERMINAL」标签页里运行
python main.py或./a.exe后乱码 → 才需要动终端代码页、环境变量、字体 - 如果连编辑器里打开文件就是乱码(比如显示“浣犲ソ”)→ 先查右下角编码标识,用「通过编码重新打开」选 GB2312/GBK,再另存为 UTF-8
Code Runner 输出乱码:只改 code-runner.executorMap 就够
Code Runner 默认走 Output 面板,它不启动真实 shell,chcp 和 terminal.integrated.encoding 对它完全无效。修复必须落在执行命令本身:
- 对于 Python:把
code-runner.executorMap中的 Python 条目改成:"python": "set PYTHONIOENCODING=utf8 && python -u $fileName"
(Windows CMD)或"python": "env PYTHONIOENCODING=utf8 python -u $fileName"
(PowerShell / Linux/macOS) - 对于 C/C++:g++ 要显式指定输入/执行字符集:
"c": "gcc -finput-charset=utf-8 -fexec-charset=utf-8 $fileName -o $fileNameWithoutExt && $fileNameWithoutExt",<br>"cpp": "g++ -finput-charset=utf-8 -fexec-charset=utf-8 $fileName -o $fileNameWithoutExt && $fileNameWithoutExt"
- 务必关闭
code-runner.runInTerminal(设为false),否则上面的set或env会被忽略
集成终端(Terminal)乱码:PowerShell profile + 环境变量双保险
只配 terminal.integrated.defaultProfile.windows 是不够的,必须在 terminal.integrated.profiles.windows 里为 PowerShell 显式注入启动参数:
- 在
settings.json中添加(注意是profiles.windows,不是defaultProfile):"terminal.integrated.profiles.windows": {<br> "PowerShell": {<br> "source": "PowerShell",<br> "args": ["-NoExit", "-Command", "$env:PYTHONIOENCODING='utf8'; chcp 65001 > $null"]<br> }<br>} -
PYTHONIOENCODING必须小写utf8(不是UTF-8或utf-8),Windows 下只有这个值被识别 - 改完后必须关闭所有已打开的 Terminal 标签页,再点「+」新建一个,reload window 不生效
- 字体要同步配:在
settings.json加"terminal.integrated.fontFamily": "'Cascadia Code', 'Microsoft YaHei', monospace",单引号包裹中文字体名
Debug Console 仍乱码:launch.json 的 env 字段不能漏
调试器控制台(F5 启动后弹出的 Debug Console)不继承终端设置,它由调试适配器独立启动:
- 在项目根目录的
.vscode/launch.json中,对应配置的configurations下加:"env": {<br> "PYTHONIOENCODING": "utf8"<br>} - 如果是 Node.js,加
"env": {"NODE_OPTIONS": "--no-warnings"}并确保终端已设chcp 65001,否则某些 warning 日志会触发 GBK 解码 fallback - Java 用户需检查
java.runtimeOptions是否含-Dfile.encoding=UTF-8,否则System.out.println("中文")仍按平台默认编码输出
最易被忽略的是:Output 面板和 Terminal 是两套完全隔离的机制,混用配置等于往油箱里加水;而 chcp 65001 在每次新开终端时都会重置,不写进 profile 就永远靠手动输。











