vscode中文乱码分四类独立场景：插件ui、集成终端、output面板、文件内容。需分别配置字体、环境变量、node.js编码及文件解码方式，错层操作无效。
VSCode中文乱码不是单一问题，而是四类场景各自独立、互不干扰：插件UI、集成终端、Output面板、文件内容。修错一层，其他层照旧乱码。
插件界面中文显示为方块或问号
这不是文件编码问题，是 VSCode 渲染插件 UI 时找不到可用中文字体。Windows 默认 fallback 字体链里没有真正覆盖简体中文的等宽字体，SimSun 在侧边栏会错位，Consolas 根本不支持汉字。
- 打开
settings.json，添加或修改"editor.fontFamily"，显式指定优先级顺序："'Microsoft YaHei', 'Sarasa Mono SC', 'sans-serif'"（单引号包裹、英文逗号分隔） - macOS 用户必须用
"PingFang SC"或"Heiti SC"；写"Helvetica Neue"会跳过所有中文渲染 - Linux 用户检查是否安装了
fonts-wqy-zenhei或noto-fonts-cjk；仅靠DejaVu Sans无法显示生僻字和 emoji
集成终端（Python/PowerShell）输出中文变 □ 或 ?
本质是进程输出编码和终端解码规则错配：Python 默认以 UTF-8 输出，但 Windows 终端默认按 CP936（GBK）解码，字节对不上就崩。
- 在
settings.json中添加："terminal.integrated.env.windows": { "PYTHONIOENCODING": "utf8" }（注意值是utf8，不是UTF-8或utf-8） - PowerShell 还需额外配置：
"terminal.integrated.shellArgs.windows": ["-ExecutionPolicy", "Bypass", "-NoLogo", "-NoProfile", "-Command", "chcp 65001"] - 改完后必须关闭所有已打开的终端标签页（
Ctrl + Shift + `全关），再新建一个才生效 - 别设
terminal.integrated.encoding—— 它已被弃用，设了也无效
Output 面板里中文全是 或空格
这是最隐蔽的一层：它和终端无关，也不走 terminal.* 配置，而是 VSCode 插件宿主进程（Extension Host）基于 Node.js 启动时默认未启用 UTF-8 模式。
-
files.encoding对 Output 面板完全无效；chcp 65001只影响集成终端，不影响 Extension Host - 若你开发插件，必须在
console.log()前手动调用：process.stdout.setEncoding('utf8') - 更通用的方案：在系统级环境变量中设置
NODE_OPTIONS=--experimental-utf8（仅 Node.js ≥18.17+ 支持）
打开 INI/JSON/配置文件时中文变成“涓枃”或 \u4f60\u597d
这是典型“解码姿势错误”：文件实际是 GBK 编码，VSCode 默认用 UTF-8 打开，把两个字节硬拆成两个 Unicode 码点，结果就是乱码。直接另存为 UTF-8 会破坏原始文件，尤其对老软件配置、游戏存档、路由器导出文件极其危险。
- 右下角点击编码显示（如
UTF-8），选Reopen with Encoding→GBK（Windows 简体中文系统下绝大多数 INI 文件用此） - 确认无误后再编辑，如需转存 UTF-8，请先备份原文件，再选
Save with Encoding→UTF-8（不是UTF-8 with BOM） - JSON 文件务必保存为 UTF-8 无 BOM；带 BOM 的 JSON 会导致
Invalid UTF-8 byte sequence错误
真正容易被忽略的是：每层乱码都有独立的生效路径，改了终端字体不影响 Output 面板，设了 PYTHONIOENCODING 不解决插件 UI 方块。修之前，先确认你在哪一层看到乱码——看错位置，所有操作都白费。
