VSCode必须使用系统已注册字体，未安装的.ttf或.zip文件无法识别；Windows需右键“为所有用户安装”，macOS需通过“字体册”启用，Linux需复制到~/.fonts并执行fc-cache -fv；配置时字体名须与系统注册名完全一致，含空格需加单引号，多字体用英文逗号分隔。
字体必须先装进系统，VSCode 才能看见
VSCode 不读取你下载的 .zip 或 .ttf 文件，只认操作系统注册过的字体。哪怕你在 settings.json 里写了 "Fira Code"，只要 Windows 字体文件没双击安装、macOS 没用“字体册”导入、Linux 没复制到 ~/.fonts 并运行 fc-cache -fv，编辑器就会静默 fallback 到 Consolas 或 'Courier New'，连字根本不会触发。
实操要点：
- Windows：解压后全选所有
FiraCode-Regular.ttf、FiraCode-Bold.ttf等（别漏掉带Ligatures后缀的），右键 → “为所有用户安装” - macOS：双击每个 .ttf → “安装字体”，然后打开“字体册”，在左侧选“用户”或“资料库”，确认字体状态是“已启用”
- Linux：把 .ttf 放进
~/.fonts/，终端执行fc-cache -fv，再用fc-list | grep -i fira验证是否列出 - 装完别急着配 VSCode，先打开系统记事本 / TextEdit，输入
=>看是否自动合并——这是最直接的连字支持验证
editor.fontFamily 值写错一个空格就失效
系统安装好字体 ≠ VSCode 能正确调用。Windows 注册的字体名可能是 Fira Code（带空格），macOS 可能是 FiraCode-Retina（无空格、带连字符），而 VSCode 的 GUI 设置框对引号和空格极其敏感。
推荐直接改 settings.json，避免 GUI 输入框吃掉引号或自动补全错误：
- Windows 用户优先试：
"'Fira Code', 'Consolas', 'monospace'" - macOS 用户打开“字体册”，右键字体 → “显示简介”，复制“全名”字段（不是文件名），比如
FiraCode-Retina，填成："'FiraCode-Retina', 'SF Mono', monospace" - 中英文混排务必加中文字体兜底，否则中文注释会模糊或基线偏移：
"'Fira Code', 'Noto Sans CJK SC', 'Microsoft YaHei', monospace" - 多个字体之间用英文逗号分隔，每个带空格的字体名必须用单引号包裹，末尾不加顿号
editor.fontLigatures 开了也不显示连字？检查三件事
"editor.fontLigatures": true 只是开关，它不保证连字一定出现。常见失效链路是：字体没加载成功 → 连字表根本没进渲染流程 → 开关形同虚设。
快速定位方法：
- 按
Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入Developer: Toggle Developer Tools，切到 Console 标签页，执行：getComputedStyle(document.body).fontFamily—— 如果返回值不含你设的字体名，说明配置压根没生效 - 确保你装的是完整版 Fira Code（GitHub Release 页面下载，不是第三方镜像打包的阉割版），部分精简包删掉了
liga、caltOpenType 特性表 - VSCode 1.84+ 对
==>、!=等复合连字支持更稳，旧版本可能只渲染=>，升级可解决 - 某些主题（尤其启用
editor.semanticHighlighting的）会干扰符号渲染，临时关掉该选项验证是否主题层叠导致
终端字体和编辑器字体完全独立
你在 editor.fontFamily 里配得再完美，集成终端（Terminal）还是默认字体。这不是 bug，是设计如此 —— VSCode 把编辑器和终端视为两个渲染上下文。
要让终端也用 Fira Code，必须单独配：
- 搜索
terminal.integrated.fontFamily，填入和编辑器一致的字体链，例如："'Fira Code', 'monospace'" - 注意：终端不支持连字（
terminal.integrated.fontLigatures是无效配置项），所以=>在终端里永远是两个字符 - 远程开发（WSL / SSH / Dev Container）时，字体必须装在**远程系统**上，本地装了没用；终端字体配置也要在远程环境的
settings.json里设
最容易被忽略的一点：中英文混排时，如果中文字体没兜底或基线不对齐，VSCode 会整行放弃连字渲染 —— 这不是配置失败，是字体回退机制主动降级。务必在 editor.fontFamily 里显式声明中文字体，并用实际代码验证中文注释的清晰度与英文对齐效果。
