Sublime Text 只能使用操作系统已注册的字体,需确保字体正确安装并刷新缓存。Windows 选“为所有用户安装”,macOS 选“电脑”范围,Linux 必须执行 fc-cache -fv;font_face 值须严格匹配注册名(大小写、空格、连字符),推荐中英双字体组合如 "Microsoft YaHei, FiraCode-Regular" 并注意顺序与行距设置。

字体必须先装进系统,Sublime 才能看见
Sublime Text 本身不安装、不管理、不缓存任何字体文件——它只从操作系统已注册的字体库中读取 font_face 字段指定的名称。你双击 FiraCode-Regular.ttf 点“安装”,或把 SourceHanSansCN.otf 拖进 macOS 字体册,都不等于 Sublime 就能用。关键在「注册成功」:Windows 要选“为所有用户安装”,macOS 要确保目标是“电脑”而非“当前用户”,Linux 必须运行 fc-cache -fv 刷新缓存。装完立刻打开系统字体管理工具确认:Microsoft YaHei、Source Han Sans CN、LXGW WenKai 这类英文全名是否真实显示出来——这才是你要抄进设置里的名字。
font_face 值必须大小写/空格/连字符完全匹配
填错一个字符,Sublime 就静默 fallback 到 Consolas 或 Courier New,不会报错也不会提示。常见错误包括:
- 写成
"font_face": "微软雅黑"(中文名无效) - 写成
"font_face": "microsoft yahei"(大小写+空格错) - 写成
"font_face": "Fira Code"(某些版本注册名为FiraCode-Regular,带连字符无空格) - 写成
"font_face": "PingFang SC"(macOS 有效,Windows 直接失效)
正确写法示例:"font_face": "Microsoft YaHei, FiraCode-Regular"(英文逗号分隔,优先中文渲染,英文符号兜底)。
Linux/macOS 不刷新缓存 = 字体白装
尤其 Linux 用户容易忽略这步:即使把字体文件复制到 ~/.fonts/ 或 /usr/local/share/fonts/,若不执行 fc-cache -fv,fc-list : family | grep -i "fira" 就查不到,Sublime 更看不到。macOS 虽然双击安装后多数情况自动注册,但若之前装过同名字体或使用了“仅限当前用户”,也建议重启 Sublime 前用字体册 App 筛选“电脑”范围再确认一次。刷新后仍不生效?检查 Preferences → Settings — User 中 JSON 是否合法:双引号、冒号后空格、末尾无多余逗号——任一格式错误都会导致整块设置被丢弃。
中英混排推荐双字体写法,别硬塞一个“全能字体”
单靠一个字体撑起中英符号,在实际编码中几乎不可行。比如 Source Han Sans CN 渲染 != 或 -> 常有间距/连字问题;Fira Code 对中文支持弱,小字号下模糊。稳妥做法是明确声明优先级:"font_face": "Microsoft YaHei, FiraCode-Regular"。这样中文、全角标点走前者,ASCII 字符、运算符、连字符号走后者。注意顺序不能反——否则中文会 fallback 成方块。另外,连字字体务必配 "line_padding_top": 1, "line_padding_bottom": 1,否则 === 类符号可能被上下像素裁切。


















