Sublime Text本身不安装字体,只调用系统已注册的字体全名;必须在系统中正确安装并确认英文全名(如“Microsoft YaHei”)、刷新缓存(Linux/macOS需fc-cache -fv)、严格按大小写空格填写font_face,否则静默fallback至默认字体。

Sublime Text 本身不安装字体,所谓“高颜值”只取决于你装进系统的字体是否被正确识别和调用。装错名字、没刷新缓存、大小写/空格差一点,就直接 fallback 到 Consolas 或 Courier New——不是编辑器丑,是你没喂对名字。
怎么确认字体真装进了系统?
Sublime 不认文件名(FiraCode-Regular.ttf)、不认中文显示名(“微软雅黑”),只认操作系统注册的「全名」,且大小写、空格、连字符全部敏感:
- Windows:打开「设置 → 蓝牙和其他设备 → 字体」,搜索字体名,点开详情看「完整名称」字段(如
Microsoft YaHei,注意无空格、无中文、无后缀) - macOS:双击字体文件 → 「显示简介」→ 查「全名」(不是「版权」或「样式」;例如
PingFang SC,不是「苹方-简」) - Linux:终端运行
fc-list : family | grep -i "fira",输出中带引号的才是真实 family name(如"Fira Code")
装完别急着开 Sublime,先在系统字体管理工具里确认这个名字是否显示出来——这是唯一可靠的验证方式。
font_face 怎么写才不静默失败?
必须写在 Preferences → Settings — User 右侧面板,JSON 格式合法,字段名一个字母都不能错:
- 单字体:
"font_face": "Microsoft YaHei"(Windows)或"font_face": "LXGW WenKai"(霞鹜文楷,WenKai 首字母大写) - 中英混合推荐:
"font_face": "Microsoft YaHei, Fira Code"(英文逗号分隔,中文优先用前者,符号/英文兜底后者) - 绝对不要写:
"font_face": "微软雅黑"、"font_face": "microsoft yahei"、"font_face": "FiraCode"(缺空格或连字符) - Linux/macOS 装了
~/.fonts/下的字体,务必运行fc-cache -fv刷新缓存,否则 Sublime 看不见
为什么改了还是方块字或默认字体?
常见静默失败原因不是 Sublime 问题,而是底层链路断了:
- 字体文件没真正安装:比如 macOS 双击后只点了「仅限当前用户」,Sublime 就看不到
-
font_face值多了一个空格、少了一个引号,或用了中文标点,JSON 解析失败后直接 fallback 到默认字体 - 用了非等宽字体(如
SimSun)但没配"font_options": ["no_antialias"],某些系统下中文渲染发虚或错位 - ST4 默认禁用部分旧字体路径,若用未更新的
YaHei Consolas Hybrid,可能被跳过
最省事的组合(2026 年实测稳定):"font_face": "Microsoft YaHei, Fira Code"(Win)、"font_face": "PingFang SC, Fira Code"(macOS)、"font_face": "Source Han Sans CN, Fira Code"(Linux 中文主力)。
行距和连字怎么调才不翻车?
line_spacing 已弃用,写了也不生效。真正控制代码行松紧的是 line_padding_top 和 line_padding_bottom:
- 默认都是 0,设成
1或2就明显更透气 - 值 >5 会导致括号高亮条变细、折叠箭头偏移、光标跳行不准,尤其在深色主题下容易漏看
- 连字字体(如
Fira Code)建议起手配"line_padding_top": 1, "line_padding_bottom": 1,避免!=符号被裁切 -
font_size是字号,line_padding_*是额外留白,单位都是 px,互不影响
侧边栏、标签页、状态栏的字体不走 font_face,得改主题文件并重启——这点最容易被忽略,调了半天代码区字体,结果左边栏还是默认灰扑扑。











