Sublime Text本身不安装字体,必须先在系统中正确安装并注册字体,再在设置中用操作系统识别的全名(大小写、空格、连字符全敏感)配置font_face;Linux/macOS还需运行fc-cache -fv刷新缓存,否则配置无效。

Sublime Text 本身不安装字体,所谓“安装开源字体”其实是两步:系统级安装 + Sublime 配置正确名称。漏掉任一环节,字体就静默失效。
开源字体必须先装进操作系统,不是拖进 Sublime
Sublime Text 不读取 .ttf / .otf 文件,只从系统字体库中查找已注册的字体全名。你双击 Fira Code.ttf 点“安装”,不等于它就被 Sublime 认出来了。
- Windows:右键字体文件 → “为所有用户安装”,然后去「设置 → 字体」确认是否显示为
FiraCode-Regular或Fira Code(看实际注册名) - macOS:双击字体 → 点“安装字体” → 打开「字体册」App → 筛选“电脑”范围 → 查右下角「完整名称」字段,比如
Fira Code或FiraCode-Retina - Linux:复制到
~/.fonts/或/usr/local/share/fonts/→ 运行fc-cache -fv→ 再用fc-list : family | grep -i fira确认输出中带引号的真实名(如"Fira Code")
font_face 必须填系统注册的全名,大小写空格一个都不能错
填错 font_face 是最常见失败原因。Sublime 不认文件名、不认中文名、不认“微软雅黑”这种显示名,只认操作系统注册的英文全名。
- 常见开源字体对应的有效值(务必按系统查到的为准):
•Fira Code→ 可能是FiraCode-Regular或Fira Code
•JetBrains Mono→ Windows 下可能是JetBrainsMono-Regular,macOS 下更可能是JetBrains Mono
•LXGW WenKai(霞鹜文楷)→ 必须写成LXGW WenKai,WenKai首字母大写,空格不能少 - 配置位置:Preferences → Settings — User(右侧面板),JSON 格式合法:
{"font_face": "Fira Code", "font_size": 13}
不要用中文引号、末尾别加逗号、冒号后建议留空格
中英混排推荐用 font_face 数组,避免方块或连字失效
单写一个中文字体(如 Microsoft YaHei),英文标点会模糊;单写一个连字英文(如 Fira Code),中文直接变方块。得靠字体链 fallback。
- 推荐写法:
"font_face": "Microsoft YaHei, Fira Code"
→ 中文优先用前者,英文/符号/连字用后者兜底 - Linux/macOS 用户若装了 Nerd Font 补丁版(如
JetBrainsMono Nerd Font),建议显式写全链:"font_face": "JetBrainsMono Nerd Font, Microsoft YaHei, monospace" - 改完设置后,必须彻底退出 Sublime(macOS 用 Activity Monitor 杀进程,Windows 查任务栏托盘),否则新配置不加载
为什么改了还是显示默认字体?先查这三处
不是 Sublime 坏了,而是底层链路断在某个环节:
- 系统字体没真装进去:打开系统字体管理工具(Windows 字体设置 / macOS 字体册),搜不到目标字体的英文全名 → 重装,注意安装范围(“电脑” or “所有用户”)
-
font_face值有隐藏空格或中文标点:复制粘贴时容易带入不可见字符,建议手动敲一遍,或用系统字体册里复制的原名 - Linux/macOS 没刷新缓存:
fc-cache -fv必须运行,且要等命令执行完再开 Sublime;macOS 若双击安装时选了“仅限当前用户”,Sublime 就看不到
最容易被忽略的是:macOS 和 Windows 对字体名大小写、空格、连字符极其敏感,而错误时 Sublime 不报错,只是安静地 fallback 到 Consolas 或 Courier New —— 你以为配成功了,其实根本没生效。











