vscode中文显示异常主因是editor.fontfamily fallback链配置错误或locale未生效；必须西文字体前置、中文字体兜底、monospace保底，如"'fira code', 'sarasa mono sc', 'noto sans cjk sc', monospace"，并严格设"locale": "zh-cn"，且彻底退出进程后重启。
VSCode中文字体显示异常，不是字体没装，而是editor.fontFamily没写对 fallback 链，或者locale根本没生效——改完不重启、不杀进程，等于白改。
editor.fontFamily 必须西文优先、中文兜底
VSCode不会自动为中文切字体，它只按你写的顺序逐个查：遇到一个汉字，先看第一个字体支不支持这个 Unicode 区段；不支持，就跳下一个。如果链里只有'Fira Code'，而它不含中文，就会 fallback 到不可控的默认字体（比如 Windows 的微软雅黑），结果就是中英文宽度不一致、光标错位、括号上下偏移。
- ✅ 正确写法（西文字体放最前，接 1–2 个已安装的编程向中文字体，最后
monospace保底）："editor.fontFamily": "'Fira Code', 'Sarasa Mono SC', 'Noto Sans CJK SC', monospace" - ❌ 错误写法（中文字体前置）：
"Microsoft YaHei", "Fira Code"→所有字符强制走微软雅黑，英文等宽失效 - 中文字体名含空格必须用英文单引号包裹，否则 VSCode 解析失败，静默退回到默认字体
-
Sarasa Mono SC和Maple Mono NF CN是专为程序员重绘的：中文全角 = 英文半角 ×2，基线对齐，标点位置与 ASCII 符号严格匹配
terminal.integrated.fontFamily 要单独配，不能复用 editor 设置
终端和编辑器字体配置项完全独立。很多人把editor.fontFamily复制到终端设置里，结果终端里中文显示方块或竖线歪斜——因为终端对等宽要求更苛刻：某些“伪等宽”中文字体（如部分Noto Sans CJK SC变体）在终端渲染时会导致光标错位、字符重叠，甚至锯齿加重。
- 终端推荐只用纯编程字体：
Fira Code、Cascadia Code、JetBrains Mono，它们原生支持多语言且度量稳定 - 配置项是
terminal.integrated.fontFamily，别漏掉integrated这一级 - 改完要关掉已打开的终端页签，再按
Ctrl+Shift+`新建一个才生效 - 终端不支持连字渲染，即使开了
editor.fontLigatures，终端里也看不到==变成⟺
locale 必须严格设为 "zh-cn"，大小写和连字符都不能错
语言包只是资源容器，locale才是开关。写错一个字符（比如zh_CN、zh-hans、Chinese）就等于没开——菜单、命令面板全英文，且不会报错。
- 必须严格写成：
"locale": "zh-cn"（小写、连字符、BCP 47 标准） - 修改位置优先级：
Configure Display Language命令 >settings.json手动加"locale": "zh-cn"> 删除locale.json文件强制回退 - 安装语言包后不要只点 “Reload” —— 它只重载插件逻辑，不刷新界面语言；必须点提示里的
Restart或手动杀进程重启 - Windows 杀
Code.exe，macOS 用 Activity Monitor 查Electron，Linux 用pkill -f 'code'，仅关闭窗口不生效
常见坑：工作区设置覆盖、字体未安装、编码不匹配
很多问题表面是字体，实际是设置被覆盖或底层编码没对齐。
- 项目根目录下的
.vscode/settings.json会覆盖用户设置，检查并删除冲突的editor.fontFamily或terminal.integrated.fontFamily - VS Code 只能使用系统中已安装的字体；macOS 用户慎用
Microsoft YaHei——它不在系统字体列表里，写了也读不到；Linux 用户需确认已安装fonts-noto-cjk或sarasa-gothic包 - 终端乱码常因编码不一致：Windows 下执行
chcp确认当前代码页是否为65001；若不是，可在settings.json中加"terminal.integrated.shellArgs.windows": ["/K", "chcp 65001"] - 文件本身是 GBK 编码，但 VSCode 用 UTF-8 打开，也会表现为“字体发虚”或“中文显示为空格”——右下角点
UTF-8选Reopen with Encoding → GBK临时验证，再Save with Encoding → utf8永久修复
真正生效的关键动作只有三个：写对 fallback 字体链、设准locale、彻底退出 VS Code 进程。其他都是障眼法。
