VSCode运行代码结果显示乱码？一招教你永久修复

先说核心结论：VSCode终端中文乱码，十有八九不是你的代码写错了，也不是Python本身出了bug，而是终端（Terminal）和Python运行时的编码链条没对齐。chcp 65001只能算临时打补丁，真正要一劳永逸，必须同时管好终端启动行为、Python环境变量和Node.js层的输出通道——三者缺一不可。

VSCode运行代码结果显示乱码，90%不是Python或程序本身的问题，而是终端（Terminal）和Python运行时的编码链没对齐——chcp 65001只是临时补丁，真正要永久修复，得同时搞定终端启动行为、Python环境变量和Node.js层输出通道。

为什么print("中文")在终端乱码，但echo "中文"正常？

这个现象说明shell（PowerShell或cmd）本身是支持中文显示的，问题出在Python解释器没有正确认领stdout的编码。Windows上常见套路是：PowerShell 5.1默认用UTF-16输出，而Python 3.8+在没设环境变量时会fallback到cp1252或cp437，字节一经过错误解码，中文就乱成了一锅粥。

• chcp 65001只改了控制台的代码页，却动不了Python进程内部的sys.stdout.encoding
• 哪怕终端已经切到了UTF-8，Python仍然可能读到os.environ.get("PYTHONIOENCODING")为空，然后就按系统区域设置去猜编码
• 更要命的是，VSCode的Debug Console和Output面板走的是Node.js通信通道，chcp根本管不着，必须单独配环境变量

terminal.integrated.env.windows必须显式设PYTHONIOENCODING=utf8

这是绕过Python编码自动探测最稳妥的方式。VSCode不会把系统级环境变量自动继承到集成终端，所以必须在settings.json里硬写进去。

• 值必须是utf8（全小写、没有短横、不带BOM），写成UTF-8或utf8bom都会被静默忽略
• 只配chcp 65001不配这个，Python仍可能输出乱码；只配这个不配chcp，某些旧版cmd会因为底层API限制无法渲染UTF-8
• Linux/macOS对应字段是terminal.integrated.env.linux或terminal.integrated.env.osx，需要设LANG=zh_CN.UTF-8

PowerShell 5.1用户务必加[Console]::OutputEncoding=[System.Text.UTF8Encoding]::new()

PowerShell 5.1有一个固有缺陷：即便chcp 65001成功了，它的Write-Host和重定向输出仍然可能使用UTF-16，Python子进程会继承这个行为。必须在启动时强制重置控制台输出编码。

• 在terminal.integrated.profiles.windows中为PowerShell profile的args追加这条命令（注意用-Command包裹）
• 不要指望Microsoft.PowerShell_profile.ps1，VSCode终端不一定加载它
• PowerShell 7（pwsh）原生支持UTF-8且没有BOM污染，如果条件允许，直接把它设为默认终端会更省心

Debug Console和Output面板乱码不能靠terminal.*配置解决

这两个面板不走终端进程，走的是VSCode前端与Node.js后端之间的IPC通信，编码由Node.js运行时决定。Windows上Node默认禁用UTF-8模式，必须靠环境变量触发。

• 仅设置terminal.integrated.env.windows对它们无效
• 必须在系统级或VSCode启动前设PYTHONIOENCODING=utf8，并确保VSCode以这个环境启动（比如从PowerShell中执行code .）
• 如果还是乱码，检查一下有没有安装干扰插件——某些“中文增强”包会劫持输出流，反而帮倒忙

真正永久修复的关键不在“多设几个配置”，而在于切断所有编码猜测路径：让终端启动即UTF-8、让Python进程明确知道IO编码、让Node.js通道不fallback到系统区域设置——任何一个环节留白，都会在某次粘贴、某次调试、某个子进程中突然复现乱码。三个环节对齐了，中文显示才算真正稳住。