VSCode 的 fontFamily 按逗号分隔从左到右 fallback，需确保首字体支持编程连字、后续字体覆盖中文及 Unicode，且所有字体均为等宽、本地已安装、名称准确。
fontFamily 配置里用逗号分隔多个字体，顺序即回退优先级
VSCode 不支持 CSS 那种 font-family: "Fira Code", "Noto Sans CJK SC", sans-serif 的写法，但逻辑一致：靠逗号分隔、从左到右依次尝试加载。只要第一个字体缺字（比如显示 emoji 或中文标点时），就自动 fallback 到下一个。
常见错误是只写一个中文字体，结果遇到编程连字（ligature）或西文符号就糊成方块；或者把等宽字体放后面，导致代码行距错乱。
-
"editor.fontFamily": "Fira Code, Noto Sans CJK SC, Consolas, 'Courier New', monospace"—— 这是合理顺序：主力编程字体 → 中文支持 → Windows 备选 → 通用兜底 - Windows 用户慎用
"Microsoft YaHei"开头：它不是等宽字体，会导致缩进错位、对齐失效 - macOS 上
"SF Mono"或"Menlo"是更稳的等宽基础，加中文需显式拼接，如"SF Mono, PingFang SC" - Linux 下
"JetBrains Mono", "Noto Sans CJK"组合兼容性较好，避免用系统默认"DejaVu Sans Mono"（缺部分 Unicode 区块）
中文字符显示异常？先确认字体是否真包含对应 Unicode 范围
不是所有“中文字体”都能显示 GBK 以外的字。比如 "SimSun" 基本不支持 emoji、数学符号、日韩平假名；"Noto Sans CJK" 覆盖全，但体积大、启动略慢。
典型现象："✅" 显示为方框、"∑" 变成问号、注释里的「①②③」无法渲染——这说明当前链路中断在某个字体上，不是 VSCode 设置问题。
- 用 VSCode 内置命令
Developer: Toggle Developer Tools，在 Console 里输入document.fonts.check('12px "Noto Sans CJK SC"')看返回值，true表示该字体已加载且可用 - 如果某字体安装了但没生效，可能是名字不匹配：Windows 查注册表或用
fc-list :lang=zh（Linux/macOS）确认实际字体名，注意空格和引号 - VSCode 1.85+ 支持
"editor.fontLigatures": true，但 ligature 和 fallback 是两回事——连字特性只在第一个字体启用，后续 fallback 字体不会继承
字体大小和 line-height 不匹配会导致视觉断层
不同字体的 x-height、ascender/descender 高度差异很大。比如 "Fira Code" 和 "Noto Sans CJK SC" 同设 14px，中文部分会明显“下沉”，光标对不齐，括号匹配高亮错位。
这不是 bug，是字体度量值天然不同。VSCode 没有 per-font 行高控制，只能折中。
- 优先统一用等宽字体家族：如
"Fira Code", "Fira Code Retina", "Noto Sans CJK SC"（后者是 Fira Code 官方推荐的中文补丁版） - 若必须混搭，把
"editor.fontSize"设为13或15，避开某些字体在14px下的度量缺陷 - 禁用
"editor.fontWeight"或固定为"normal"：粗体切换可能让 fallback 字体突然变细/变粗，造成视觉跳动
远程开发（SSH/WSL/Docker）下字体路径不共享，fallback 会失效
VSCode Remote 扩展运行在远端，但字体渲染发生在本地客户端。远端配置的 fontFamily 只是告诉本地：“请按这个顺序找字体”。如果本地没装 "Fira Code"，哪怕远端有也没用。
最常被忽略的一点：远程窗口里看到的字体，100% 来自你本机，和服务器字体库完全无关。
- 检查本地是否真安装了列表里的每个字体：macOS 在“字体册”，Windows 在
C:\Windows\Fonts，Linux 看/usr/share/fonts/或用户目录~/.local/share/fonts/ - WSL 用户容易误以为在 WSL 里
sudo apt install fonts-noto-cjk就够了——其实只是装了远端字体文件，对渲染无影响 - 如果用 VSCode for Web（github.dev），那所有字体都来自浏览器支持范围，
fontFamily最多 fallback 到system-ui，别指望自定义中文字体
