VSCode 中文显示异常的根源在于字体名拼写、fallback链和系统安装状态三者未同时匹配；应使用系统真实注册名、中英分离配置、显式fallback，并设合适字号与行高。
VSCode 里设中文字体，不能只填“微软雅黑”或“思源黑体”就完事——中文渲染依赖字体名拼写、fallback 链、系统安装状态三者同时正确，否则要么显示方块，要么回退到极细的英文等宽字体。
为什么改了 editor.fontFamily 中文还是糊/发虚/显示异常
常见错误不是没装字体，而是配置没对上系统实际注册名：
-
editor.fontFamily值里写"Microsoft YaHei"（Windows）但系统实际注册的是"Microsoft YaHei UI"，结果 fallback 到Consolas，中文全成小方块 - macOS 下写
"PingFang SC"是对的，但若混在'Fira Code', 'PingFang SC'里且没加单引号，整个字符串解析失败，直接用默认字体 - Linux 用户装了
Noto Sans CJK SC，但包名是fonts-noto-cjk，需确认是否真正注册进 fontconfig（可终端执行fc-list | grep -i "noto"验证） - 用了连字字体（如 Fira Code）+ 中文字体混排，但没关
editor.fontLigatures，部分中文字形会被 ligature 引擎错误处理，出现断笔或重叠
editor.fontFamily 的安全写法：中英分离 + 显式 fallback
推荐按「主力中文字体 → 备选中文字体 → 英文等宽主力 → 终极 fallback」顺序写，全部用单引号包裹，逗号后不加空格（VS Code 解析器对空格敏感）：
"editor.fontFamily": "'HarmonyOS Sans SC', 'Noto Sans CJK SC', 'Microsoft YaHei UI', 'PingFang SC', 'Fira Code', 'JetBrains Mono', 'Consolas', 'monospace'"
说明：
- Windows 用户优先放
'Microsoft YaHei UI'（不是YaHei），它是 Win10+ 默认 UI 字体，中文渲染最稳 - macOS 用户
'PingFang SC'必须带SC后缀，否则可能调用旧版字体导致标点错位 - Linux 用户推荐
'Noto Sans CJK SC'，比'WenQuanYi Micro Hei'更现代，支持 emoji 和更多汉字 - 末尾保留
'monospace'是关键——它确保即使所有指定字体都缺失，也不会降级到非等宽字体，避免缩进错乱
字号和行高必须配合中文阅读习惯调
中文字符视觉密度高于英文，editor.fontSize 设 14px 在英文下刚好，在中文里常显拥挤；editor.lineHeight 若为 0（默认），VS Code 会按字体度量自动算，但中文字体自带行距不统一，容易导致上下行粘连：
-
editor.fontSize建议设为15或16（整数！小数如15.5会被静默丢弃） -
editor.lineHeight务必设为具体值，比如22或24；经验公式：中文下lineHeight ≈ fontSize × 1.5 - 如果开了
editor.fontLigatures，建议关掉——目前主流中文字体不支持 ligature，开反而增加渲染负担，还可能让中文标点（如「」『』）显示异常
终端（Terminal）中文显示要单独配，且更脆弱
内置终端用的是独立渲染管线，editor.fontFamily 对它完全无效。常见问题：
- 终端里中文正常，但
ls输出的中文文件名显示为???：这不是字体问题，是 locale 没设好（Linux/macOS 需检查locale命令输出是否含UTF-8） - 终端字体设了
'Noto Sans CJK SC'还是发虚：加"terminal.integrated.fontWeight": "normal"，避免主题插件强行加粗导致中文字形崩坏 - 必须同步设
terminal.integrated.fontSize，且值建议和editor.fontSize一致——眼睛不用反复适应大小差 - 改完 terminal 配置，已打开的终端页签不会刷新，必须按
Ctrl + Shift + `新建一个才生效
最常被忽略的一点：中文字体名在不同系统里大小写、空格、后缀都不一样，复制网上教程的字符串大概率失效；与其死记，不如打开系统字体册（Windows 字体设置、macOS 字体册、Linux fc-list）查真实注册名，再粘贴进 settings.json。多试两轮，比猜十次靠谱。
