Fira Code 连字失效主因是系统未注册字体，须先通过系统字体管理器安装（Windows选“为所有用户安装”、macOS用“字体册”启用并复制全名、Linux执行fc-cache -fv），再在settings.json中用单引号准确填写注册名（如'Fira Code'或'FiraCode-Retina'），并设"editor.fontLigatures": true，最后完全重启VSCode。
Fira Code 在 VSCode 里显示不出连字，不是字体没下对，而是系统根本没“认”它——编辑器只读操作系统注册表里的字体名，不认你硬盘里躺着的 .ttf 文件。
怎么确认 Fira Code 已被系统真正安装
VSCode 启动时会扫一遍系统字体表，没出现在里面的字体，哪怕 settings.json 里写得再准，也会静默 fallback 到 Consolas 或 Courier New。
- Windows：打开
C:\Windows\Fonts，搜索Fira Code，必须看到带图标的完整条目（含Regular、Bold、Retina等变体） - macOS：用「字体册」App 搜索
Fira Code，右下角显示「已安装」；右键 →「显示简介」→ 复制「全名」字段（常见为FiraCode-Retina，不是文件名FiraCode-Regular.ttf） - Linux：终端执行
fc-list | grep -i "Fira Code"，有输出才算装好；若无，把.ttf放进~/.local/share/fonts/后运行fc-cache -fv - 验证连字是否就绪：打开系统记事本 / TextEdit，字体列表里能搜到并选中该字体，输入
=>看是否自动变成⇒
settings.json 里 editor.fontFamily 怎么写才不失效
editor.fontFamily 值写错一个空格或引号就失效。GUI 设置框对引号和空格极其敏感，容易吃掉单引号或自动补全错误，强烈建议直接改 JSON。
- Windows 用户通常填
'Fira Code'；若无效，试试'FiraCode-Regular'（部分系统注册名不含空格） - macOS 用户务必用「字体册」里复制的「全名」，比如
'FiraCode-Retina'，别手敲 - 中英文混排必须加中文字体兜底，否则中文注释基线偏移、模糊：
'Fira Code', 'Noto Sans CJK SC', 'Microsoft YaHei', monospace - 多个字体用英文逗号分隔，每个带空格/特殊字符的字体名都得加单引号，别写成
"'Fira Code'"（双引号套单引号）
为什么连字开关 editor.fontLigatures 必须显式设为 true
只配 editor.fontFamily 不够，只装字体也不够——VSCode 默认关闭连字，必须显式启用且完全退出进程才生效。
- 配置项是
editor.fontLigatures，值必须是布尔型true，不是字符串"true" - 拼写不能错：
fontLigatures（不是fontLigature或ligatures） - 想激活更多连字变体（如
!==显示为≢），可显式指定 OpenType 特性："editor.fontLigatures": "'calt', 'ss01', 'ss02', 'ss03', 'ss04', 'ss05'" - 改完后，用
Ctrl+Shift+P（macOS 是Cmd+Shift+P）打开命令面板，输入Developer: Toggle Developer Tools，在 Console 里执行getComputedStyle(document.body).fontFamily，返回值里必须包含你设的字体名，否则配置压根没生效
终端里 Fira Code 连字怎么同步生效
编辑器和终端用的是两套字体配置，editor.fontFamily 不影响终端。必须单独配 terminal.integrated.fontFamily，且同样要启用连字。
- VSCode 配置项是：
"terminal.integrated.fontFamily": "'Fira Code'"和"terminal.integrated.fontLigatures": true（注意：这是 VSCode 1.89+ 才支持的配置项，旧版本无效） - Remote-SSH / WSL 场景下，
terminal.integrated.fontFamily只起提示作用，真正生效的是远程系统是否安装了Fira Code；本地装了没用 - 终端字符重叠或光标错位？可微调：
"terminal.integrated.letterSpacing": 0.5 - 字号建议设为 14 或 15——太小连字细节糊，太大字符间距松散
最容易被忽略的一点：改完所有配置后，必须完全退出 VSCode（不只是关窗口），再重新启动；否则连字不会加载。很多人卡在这一步，反复检查字体名和设置，却忘了进程没真正重启。
