fira code连字不显示主因是字体未系统级安装,须同时完成三步:系统正确安装字体(windows查c:\windows\fonts、macos用字体册确认全名、linux执行fc-list验证)、vscode中settings.json用单引号写对字体名(如'fira code'或'firacode-retina')、显式启用"editor.fontligatures": true并完全退出vscode生效。

Fira Code 连字不显示,90% 是字体根本没装进系统,不是 VSCode 设置错了。 它不会自动生效,必须三件事全做对:系统级安装字体、VSCode 里写对字体名、显式开启连字开关。缺一不可,且顺序和引号稍错就静默失败。
确认 Fira Code 已正确安装到系统
VSCode 不自带字体,只读取系统已注册的字体。哪怕你在设置里写了 Fira Code,系统里没它,编辑器就直接 fallback 到 Consolas 或 monospace,连字自然不会出现。
- Windows:打开
C:\Windows\Fonts,搜索Fira Code,必须看到完整条目(含 Regular、Bold、Retina 等变体),不能只是解压出来的 .ttf 文件 - macOS:打开「字体册」App,顶部搜索
Fira Code,右下角显示“已安装”,并点开字体 →「显示简介」→ 复制“全名”字段(常为FiraCode-Retina或Fira Code,空格/连字符差一个都不行) - Linux(Ubuntu/Debian):终端执行
fc-list | grep -i "Fira Code",有输出才算成功;若无,复制 .ttf 到~/.local/share/fonts/后运行fc-cache -fv
验证方式:打开记事本(Windows)或 TextEdit(macOS),在字体列表里能搜到、选中后输入 => 或 != 能看到连体符号,才算真正就位。
VSCode 中 editor.fontFamily 必须用单引号写对字体名
GUI 设置界面容易漏引号或大小写,建议直接改 settings.json。字体名必须与系统注册名完全一致,否则 VSCode 解析失败,跳过该字体继续往后找。
- Windows 用户通常填
'Fira Code';若无效,试试'FiraCode-Regular' - macOS 用户务必用「字体册」里复制的“全名”,比如
'FiraCode-Retina',别手敲 - 多个字体用英文逗号分隔,每个带空格/特殊字符的字体名都得加单引号:
'Fira Code', 'Noto Sans CJK SC', 'monospace' - 别写成
"'Fira Code'"(双引号套单引号),UI 设置里会把整个字符串当字体名,导致找不到
改完后,用 Ctrl+Shift+P(macOS 是 Cmd+Shift+P)打开命令面板,输入 Developer: Toggle Developer Tools,在 Console 里执行 getComputedStyle(document.body).fontFamily,返回值里必须包含你设的字体名,否则配置压根没生效。
editor.fontLigatures 必须设为 true,且要完全退出 VSCode 才生效
只设 editor.fontFamily 不够,只开 editor.fontLigatures 也不行——两者缺一不可。而且这个开关是大小写敏感的:fontLigatures,不是 fontLigature 或 ligatures。
- 在设置里搜
font ligatures,勾选Editor: Font Ligatures(值为true) - 或者在
settings.json里加一行:"editor.fontLigatures": true - 改完必须完全退出 VSCode 进程:Windows 右键任务栏图标 →「退出」,macOS 按
Cmd + Q,不能只是关窗口
连字不是“开了就全有”。Fira Code 默认只支持常见组合(=>、!=、==),=== 或 **= 可能不支持。去 GitHub 查你装的版本是否为 latest release 的 FiraCode_*.zip,别误装了 Nerd Fonts 衍生版。
中英文混排时中文发虚?补中文字体兜底 + 关连字
Fira Code 是纯西文字体,不含中文字符。代码里有中文注释或变量名时,VSCode 会 fallback 到默认中文字体,但 fallback 链配置不当就会导致中英文粗细/清晰度不一致,看着像“糊”或“断层”。
- 在
editor.fontFamily里显式补上中文字体兜底,例如:'Fira Code', 'Noto Sans CJK SC', 'Microsoft YaHei', 'monospace' - 中文注释多时,建议直接关掉连字:
"editor.fontLigatures": false,因为连字只作用于 ASCII 符号,对中文无意义,还可能干扰渲染节奏 - 字号别设太小(如 12),Windows 下 14、macOS 下 13 是较稳起点;行高建议
"editor.lineHeight": 1.5或具体像素值(如 22)
改完记得检查注释里的中文是否清晰、和英文基线对齐——这是很多人配完以为成功,实则“半残”的关键盲区。











