Sublime Text不安装字体,需先系统注册再用全名配置font_face;Windows查设置中“完整名称”,macOS看字体册“全名”,Linux用fc-list验证;填错即静默回退至Consolas。

Sublime Text 本身不安装字体,所谓“安装无衬线字体”本质是两步:把字体文件注册进操作系统,再用系统识别的全名(大小写、空格、连字符全部敏感)填进 font_face。填错一个字符,就静默 fallback 到 Consolas 或 Courier New。
怎么确认字体已真正装进系统?
别信“双击安装完成”——那只是触发系统安装动作,不代表 Sublime 能看见。
- Windows:打开「设置 → 蓝牙和其他设备 → 字体」,搜索目标字体(如
Microsoft YaHei),点开看「完整名称」字段是否显示一致 - macOS:双击 .ttf 文件 → 「显示简介」→ 查「全名」(不是「版权」或「样式」),且确保在「字体册」App 中状态为「已启用」且范围是「电脑」
- Linux:终端运行
fc-list : family | grep -i "fira",输出中带引号的才是真实 family name,例如"Fira Code";若无输出,说明缓存未刷新,必须执行fc-cache -fv
font_face 填什么才生效?常见无衬线字体全名对照
填错名字是 90% 的失败原因。Sublime 不认中文名、不认文件名、不认缩写,只认系统注册的英文全名。
-
Microsoft YaHei(Windows 微软雅黑,注意无空格、无“-”、大小写固定) -
Source Han Sans CN(思源黑体简体,CN 后缀不能少,空格不能错) -
LXGW WenKai(霞鹜文楷,WenKai 首字母大写) -
Fira Code或FiraCode-Regular(取决于系统注册名,部分 Linux/macOS 注册为后者) -
JetBrains Mono或JetBrainsMono Nerd Font(Nerd Font 补丁版才支持图标,原版不行)
中英文混排更稳写法:"font_face": "Fira Code, Microsoft YaHei"(英文逗号分隔,前面优先渲染符号和英文,后面兜底中文)
为什么改了 font_face 还是显示方块或默认字体?
这不是 Sublime 故障,而是底层链路断了:
-
font_face值多了一个空格、少了一个引号,或用了中文逗号/冒号,JSON 解析失败后直接 fallback - 字体装了但没为「所有用户」安装(Windows)或没选「电脑」范围(macOS),Sublime 进程看不到
- Linux/macOS 装完没运行
fc-cache -fv或「字体册 → 验证字体」,缓存未更新 - 用了非等宽无衬线字体(如
Helvetica)但没配"font_options": ["no_antialias"],高 DPI 下中文发虚或错位
改完设置要不要重启 Sublime Text?
font_face 和 font_size 保存后编辑区会实时刷新,但侧边栏、标签页、命令面板等 UI 元素必须彻底退出再重开才生效。
- Windows:任务管理器结束所有
subl.exe进程,或右键托盘图标 → “退出” - macOS:Activity Monitor 搜索
subl或Sublime Text,强制退出;只关窗口不够 - Linux:终端执行
pkill -f "subl"或killall subl
最常被忽略的一点:UI 字体(侧边栏、菜单栏)不由 font_face 控制,得改当前主题的 .sublime-theme 文件,且必须重启才能加载新样式。











