怎么解决VSCode终端乱码问题-GBK转UTF-8编码设置指南-VSCode-PHP中文网

vscode终端乱码本质是windows默认gbk编码与utf-8输出不匹配，需同步调整shell代码页（如chcp 65001）、powershell的$outputencoding、python的pythonioencoding及中文字体配置，修改后必须关闭所有终端重开。

怎么解决vscode终端乱码问题-gbk转utf-8编码设置指南

VSCode 终端乱码本质是编码不匹配，不是字体或主题问题；Windows 默认 cmd/powershell 用 GBK，而 VSCode 内置终端默认尝试 UTF-8，冲突就出现或方块。

确认终端当前编码和乱码类型

先区分是「中文路径/文件名显示为问号」还是「执行 Python/Node 脚本时 print 输出乱码」——前者多是 shell 层编码未同步，后者常是程序自身没声明编码。在终端里运行：chcp，输出类似 活动代码页: 936 就表示当前是 GBK（936 = GBK）。如果脚本里 print("你好") 显示乱码，但 chcp 显示 65001（UTF-8），说明终端已切 UTF-8，但 Python 进程仍按系统默认（GBK）解码源码——这时要改 Python 启动参数或文件头声明。

修改 VSCode 终端默认编码为 UTF-8

VSCode 本身不直接控制终端编码，它依赖底层 shell 的启动配置。关键操作分两步：

VSCode

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

下载

对 Windows Terminal 或新版本 PowerShell：在 VSCode 设置中搜索 terminal.integrated.defaultProfile.windows，设为 powershell（非 cmd），再打开 settings.json 加入：

"terminal.integrated.profiles.windows": {
  "PowerShell": {
    "source": "PowerShell",
    "args": ["-NoExit", "-Command", "$env:PYTHONIOENCODING='utf-8'; chcp 65001 > $null"]
  }
}

若坚持用 cmd：不能靠 chcp 65001 一劳永逸，因为 VSCode 每次新建终端都会重置。必须在 terminal.integrated.profiles.windows 中为 cmd 配 args，例如：
```
"cmd": {
  "path": "cmd.exe",
  "args": ["/c", "chcp 65001 > nul && cmd.exe"]
}
```
注意：修改后需关闭所有终端再新建，旧终端不会自动刷新编码

Python 脚本输出乱码的补救措施

即使终端设成 UTF-8，Python 2.7 或未声明编码的 Python 3 文件仍可能用系统 locale 解码字符串，导致 print 出错。常见应对：

Python 3 文件开头加 # -*- coding: utf-8 -*-（虽 PEP 3120 规定默认 UTF-8，但某些 Windows 环境仍需显式声明）
运行时强制指定编码：用 python -X utf8 script.py（Python 3.7+），或设置环境变量 PYTHONIOENCODING=utf-8
避免 os.system("echo 你好") 类调用：子进程继承父进程编码，但 cmd 自身不理解 UTF-8 字节流，会二次转义；改用 subprocess.run 并明确 encoding="utf-8"

别忽略的细节：Node.js 和 Git Bash 行为差异

Node.js console.log("你好") 在 UTF-8 终端下通常正常，但若用 child_process.exec 调 cmd 命令，返回值仍是 GBK 编码的 Buffer——必须手动 buf.toString('gbk')。Git Bash（msys2）则默认 UTF-8，但它的 ls 对含中文路径的显示依赖 LANG 环境变量，VSCode 中需在 terminal.integrated.env.windows 里加：

"LANG": "zh_CN.UTF-8"

。这些细节不报错，但结果不对，容易误判为“已解决”。