VSCode中print("中文")输出方块、问号或空格,90%是Python进程与Windows终端编码未对齐所致;需通过chcp和python -c "import sys; print(sys.stdout.encoding)"确认是否为cp936错配,在settings.json中添加"terminal.integrated.env.windows": {"PYTHONIOENCODING": "utf8"}并重启终端,Code Runner和Debug Console需分别配置executorMap与launch.json。

VSCode里print("中文")输出方块、问号或空格,90%不是文件编码错了,而是Python进程和Windows终端解码规则没对齐——改右下角“UTF-8”或files.encoding完全无效。
怎么确认是终端编码错配,不是文件问题
先看现象区分根源:
- 编辑器里中文显示正常,但终端
print()输出乱码 → 终端层问题 - 编辑器一打开就是□或
\u4f60\u597d→ 文件读取错位(这时才该调files.encoding) - 终端里
echo 你好正常,但python -c "print('你好')"乱码 → Python进程没对齐终端编码
验证必须跑两行命令:
chcp —— 如果输出“活动代码页: 936”,说明终端当前用GBK
立即学习“Python免费学习笔记(深入)”;
python -c "import sys; print(sys.stdout.encoding)" —— 如果输出cp936(不是utf-8),就坐实了错配
settings.json 必加的环境变量配置
这是最稳、覆盖所有启动方式(终端直接运行、Code Runner、Tasks)的方案:
"terminal.integrated.env.windows": {"PYTHONIOENCODING": "utf8"}
注意三点:
- 大小写敏感:
utf8必须全小写、无横线;UTF-8或utf-8在Windows下无效 - 加完后必须关闭所有已打开的终端标签页(
Ctrl + Shift + `全关掉),再新建一个才生效 - 别碰
terminal.integrated.encoding——它已被弃用,设了也无效
Code Runner插件要单独改执行命令
Code Runner默认不读terminal.integrated.env.windows,会绕过你的配置:
- 进插件设置 → 找到“Code Runner: Executor Map” → 编辑
python项 - 把默认值
"python -u $fileName"改成:"set PYTHONIOENCODING=utf8 && python -u $fileName"(Windows) - Linux/macOS则用:
"export PYTHONIOENCODING=utf8 && python -u $fileName"
否则你改了全局环境变量,Code Runner一运行还是乱码。
Debug Console(F5调试输出框)仍乱码怎么办
Debug Console不继承终端环境变量,得单独配launch.json:
- 在
.vscode/launch.json的配置项里加:"env": {"PYTHONIOENCODING": "utf8"} - 或者更推荐:
"console": "integratedTerminal",让调试输出重定向到底部终端,避开Debug Console解析缺陷 - 如果必须用Debug Console,在Python脚本开头加:
import sys; sys.stdout.reconfigure(encoding='utf-8')(仅Python 3.7+支持)
别信os.environ['PYTHONIOENCODING'] = 'utf-8'——调试器不一定读这个,写在代码里也不如reconfigure直接有效。
真正容易被忽略的是PowerShell本身的输出编码:即使chcp 65001成功,[Console]::OutputEncoding可能仍是Default(即cp936),这会导致某些.NET调用或子进程输出依然乱。必须在settings.json里补全terminal.integrated.profiles.windows配置,显式重置它。


















