根本原因是Windows终端默认GBK编码与后端程序UTF-8输出冲突，必须在terminal.integrated.profiles.windows中为PowerShell配置chcp 65001启动参数以强制UTF-8代码页，同时指定中文字体并重启终端验证。

VSCode 运行后端服务（如 Node.js、Python、Java）时终端输出中文乱码，根本不是文件编码问题，而是 Windows 终端子进程的代码页（code page）与 VSCode 集成终端的 UTF-8 解析逻辑不匹配——chcp 65001 必须在 shell 启动时执行，否则 console.log("你好") 或 print("测试") 输出的字节流永远被当成 GBK 解码。

terminal.integrated.profiles.windows 必须显式配置 chcp 65001

很多人只改了 terminal.integrated.defaultProfile.windows，但没配 terminal.integrated.profiles.windows，导致 PowerShell 启动时不执行 chcp 65001，终端左下角显示的是 PowerShell（5.1）而非 powershell（7+），说明配置未生效。

• PowerShell 5.1：在 settings.json 中添加如下配置（注意是 profiles.windows，不是 defaultProfile）：

  "terminal.integrated.profiles.windows": {
    "PowerShell": {
      "source": "PowerShell",
      "args": ["-NoExit", "-Command", "chcp 65001 | Out-Null"]
    }
  }

• PowerShell 7+：虽默认 UTF-8，但仍建议保留 chcp 65001，避免调用旧版 git、curl 等外部命令时回退到 cp936
• cmd 场景：使用 ["/K", "chcp 65001"]，/K 确保命令执行后终端保持打开
• 改完必须重启 VSCode 终端（关闭再新建），仅 reload window 不生效

字体设置不等于编码修复，但缺它照样显示为方块

即使 chcp 65001 完全正确，如果终端字体不支持中文，你看到的不是乱码，而是空白或方块 —— 这是渲染失败，不是解码失败。VSCode 不会自动 fallback 到系统中文字体，必须手动指定。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 在 settings.json 中设置：

  "terminal.integrated.fontFamily": "'Cascadia Code', 'Microsoft YaHei', 'SimSun', monospace"

• 中文字体名必须用单引号包裹，多个字体用英文逗号分隔
• 不要只写 "Microsoft YaHei"：遇到 emoji、CJK 扩展区字符（如某些生僻汉字）时会直接 fallback 到方块
• Mac/Linux 用户需自行安装 Cascadia Code，否则跳过该字体继续尝试下一个

后端程序自身输出编码也要对齐

终端编码设对了，不代表后端程序就一定输出 UTF-8 字节。某些语言运行时或框架会读取系统环境变量（如 PYTHONIOENCODING、LANG）来决定 stdout 编码，Windows 下这些变量常为空或错设。

• Node.js：通常没问题，但若用 child_process.spawn 调用 cmd 工具，需确保子进程也运行在 UTF-8 code page 下（即上一步已生效）
• Python：在 Windows 上建议加环境变量 PYTHONIOENCODING=UTF-8（系统级或 VSCode launch.json 的 env 字段）
• Java：启动参数加 -Dfile.encoding=UTF-8，同时确保 System.out.println("中文") 的 JVM 运行环境未被 IDE 插件覆盖编码设置
• 验证方式：在终端直接运行 python -c "print('测试')"，若仍乱码，说明终端层没配好；若正常，但你的服务乱码，则问题出在服务自身启动上下文

最常被忽略的一点：chcp 65001 是会话级命令，只对当前 shell 实例生效。VSCode 每次新建终端都新开一个 PowerShell 进程，所以必须靠 args 注入启动命令，而不是靠用户手动敲一次完事。字体和后端编码是锦上添花，但没有这一步，其他全是白搭。