VSCode中文显示异常是编码链路断裂所致，需同步排查文件编码、终端代码页、环境变量、字体渲染四层配置，任一环节错配均导致问号、方块或Unicode转义。
VSCode 输出中文显示异常，不是单一原因导致的「界面 bug」，而是多个层级配置错位叠加的结果。核心判断是：问题大概率不出在编辑器本身，而在于编码链路断裂——从文件保存、终端进程、系统环境到字体渲染，任一环不匹配，中文就变方块、问号或 Unicode 转义序列（如 \u4f60\u597d）。
文件编码与解码不一致导致打开即乱码
这是最常见也最容易验证的问题：你看到的「输出」其实是 VSCode 用错误编码读取了本应是 UTF-8 或 GBK 的文件内容。
- 右下角状态栏显示的
UTF-8只是当前“声称”的编码，不代表文件真实编码；若原始文件是记事本保存的 GBK，VSCode 按 UTF-8 解就会满屏方块 -
files.autoGuessEncoding默认为false，不会自动识别，尤其对无 BOM 的 GBK 文件完全失效 - 手动点击右下角 →
Reopen with Encoding→ 试GBK/GB2312/Big5，能立刻恢复说明就是它 - 别在乱码状态下直接
Ctrl+S保存——会把乱码固化为新文件内容
终端进程未启用 UTF-8 导致程序输出乱码
VSCode 集成终端只是个“窗口”，真正执行 python main.py 或 node index.js 的是底层 shell（PowerShell、cmd、Git Bash、WSL）。它们有自己的代码页或 locale 设置，和 VSCode 的 files.encoding 完全无关。
- Windows PowerShell 默认代码页是
936（GBK），但 Python 默认以 UTF-8 输出字节流 → 两边解码规则打架，结果就是□□□ - 临时验证：在终端里先运行
chcp 65001（切换为 UTF-8），再跑程序，若正常说明就是代码页问题 - Git Bash/WSL 看
locale输出，若LANG=zh_CN.GBK就得改成zh_CN.UTF-8，且必须在 WSL 侧用sudo dpkg-reconfigure locales生效 -
terminal.integrated.env.windows中设PYTHONIOENCODING: "utf8"是补救，不是根治；根本要让 shell 自身运行在 UTF-8 环境
locale.json 未正确生成或被覆盖导致界面语言失效
装了中文语言包却仍是英文界面？不是插件没装好，而是 locale.json 这个关键文件没写进去，或内容被其他配置覆盖。
-
Configure Display Language命令是唯一合法入口；手改settings.json加"locale": "zh-cn"完全无效 - 检查路径：
$HOME/Library/Application Support/Code/User/locale.json（macOS）、%APPDATA%\Code\User\locale.json（Windows）——内容必须是{"locale":"zh-cn"}，多一个空格或逗号都可能被静默忽略 - 工作区级
.vscode/settings.json若含"locale": "en"，会强制覆盖用户设置；远程开发时，远程容器也有独立的locale.json，需单独执行命令 - 文件存在但权限为只读（尤其 WSL 挂载场景），VSCode 无法更新，重启后 fallback 到英文
字体链缺失或系统级字体未配置导致渲染失败
即使编码全对、语言已切，中文仍显示为空心方块（□），说明终端或编辑器找到了字节，但找不到对应字形来画。
-
terminal.integrated.fontFamily必须填入支持中文的等宽字体链，例如："Cascadia Code", "Microsoft YaHei", "Sarasa Gothic SC", monospace；单写"Consolas"不行，它不含中文 - VSCode 设置里的字体只控制「渲染层」，Windows 终端窗口右键 → 属性 → 字体，也要手动选一个中文字体（不能留默认“点阵字体”）
- macOS 上若用系统自带 Terminal.app 启动 VSCode，其
LANG可能继承自 Shell，但字体渲染走的是 macOS 的 Core Text，需确认系统字体册中已安装简体中文字体 - 某些企业策略或旧版 Windows（如 1809 之前）会禁用 UTF-8 全局支持，此时连
chcp 65001都无效，只能换 Git Bash 或升级系统
真正麻烦的从来不是某一个设置，而是这些层级之间互相看不见：shell 不知道 VSCode 的 files.encoding，VSCode 不干预终端进程的 LC_CTYPE，字体渲染又依赖操作系统最后兜底。调一个地方没用，是因为其他环节还在按旧规则运行。
