VSCode的editor.fontFamily必须用逗号分隔多个等宽字体并按回退优先级排序，单写中文字体（如"Microsoft YaHei"）会导致缩进错位、光标不对齐及Unicode字符显示为方块，因其非等宽且不支持扩展Unicode区块。
VSCode 的 editor.fontFamily 必须用逗号分隔多个等宽字体，顺序即回退优先级；只写一个字体（哪怕叫“Noto Sans CJK”）大概率导致 emoji、数学符号或中文标点显示为方块。
为什么单写中文字体就出问题
常见错误是把 editor.fontFamily 设成 "Microsoft YaHei" 或 "SimSun" —— 这俩都不是等宽字体，会导致缩进错位、光标对不齐、括号高亮偏移。更关键的是，它们基本不支持 Unicode 扩展区：比如 ✅、∑、①、日文平假名、越南语声调符号，全会 fallback 到系统默认字体（通常是模糊的 monospace），甚至直接变方框。
真正起作用的不是“有没有中文字体”，而是“整条链里有没有字体覆盖当前字符的 Unicode 区块”。VSCode 不会智能拆字、也不会跨字体渲染单个字符——它只按顺序查每个字体是否包含该码点。
- 第一个字体（如
Fira Code）负责连字和西文符号，但不含中文 - 第二个字体（如
Noto Sans CJK SC）补中文、日韩、常用 emoji，但缺部分数学符号 - 第三个字体（如
Consolas）兜底西文，确保纯 ASCII 行不崩 - 最后用
monospace保底，防止整个链断裂
Windows/macOS/Linux 字体名怎么写才对
字体名必须和系统注册/安装时的全名完全一致，大小写、空格、连字符都不能错。VSCode 不识别别名，也不做模糊匹配。
Windows 上推荐用："Fira Code", "Noto Sans CJK SC", "Consolas", "Courier New", monospace
macOS 上推荐用："SF Mono", "PingFang SC", "Noto Sans CJK SC", monospace
Linux 上推荐用："JetBrains Mono", "Noto Sans CJK SC", "DejaVu Sans Mono", monospace
注意：Microsoft YaHei 要加单引号写成 'Microsoft YaHei'，否则 VSCode 解析失败；PingFang SC 同理。如果不确定本地有没有某个字体，Linux/macOS 可运行 fc-list :lang=zh | grep -i "noto\|pingfang"，Windows 可查注册表 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts。
emoji 和彩色图标显示异常怎么办
普通中文字体（包括 Noto Sans CJK SC）不带彩色 emoji 支持。如果代码里有 ?、?、? 显示为黑白或方块，说明回退链没接上专用 emoji 字体。
- Windows：在链尾加
'Segoe UI Emoji' - macOS：加
'Apple Color Emoji' - Linux：加
'Noto Color Emoji'
示例完整配置（Windows）："editor.fontFamily": "'Fira Code', 'Noto Sans CJK SC', 'Segoe UI Emoji', 'Consolas', monospace"。注意 Segoe UI Emoji 必须放在中文字体之后、西文字体之前——它含中文字符但渲染质量差，放太前会干扰正常中文显示。
字体大小一致，但中文“下沉”、光标不对齐
不同字体的 x-height、ascender、descender 高度差异很大。Fira Code 和 Noto Sans CJK SC 同设 14px，中文部分视觉上会明显比英文低，括号匹配高亮错位、光标悬停位置不准都是典型表现。
解决办法只有两个：
- 选一套设计统一的字体组合，比如
"JetBrains Mono", "Noto Sans CJK SC"（两者 x-height 接近） - 手动调小中文部分字号：VSCode 不支持 per-font-size，只能妥协——把整体
editor.fontSize设为13，再靠editor.lineHeight拉高行距缓解错位感
别碰 editor.fontLigatures 来救显示——连字只在第一个字体生效，后续 fallback 字体不会继承该特性，开了也白开。
