Sublime Text 不安装字体,仅调用系统已注册的 PingFang SC;macOS 自带且需在「字体册」中确认全名为“PingFang SC”,Windows 无原生支持,强行配置会 fallback 至 Courier New。

Sublime Text 不能“安装”苹方字体,它只读取系统已注册的 PingFang SC;macOS 自带该字体,但 Windows 和 Linux 没有,强行填会 fallback 到 Courier New。
确认系统是否真有 PingFang SC
苹方是 macOS 原生字体,不随 Sublime 一起分发,也不支持跨平台复制使用。你双击 .ttf 文件、或在设置里写 "font_face": "PingFang SC",前提是系统已注册这个名字——不是“显示为苹方”,而是注册全名必须一字不差。
- 打开 macOS「字体册」App → 左侧选「电脑」→ 搜索
PingFang SC→ 点开详情,看「全名」字段是否就是PingFang SC(注意大小写、空格、无后缀) - 如果显示的是
PingFang SC Light或PingFang TC,那不能直接填PingFang SC,得按实际全名来 - Windows 用户别试:就算手动装了第三方 PingFang 字体文件,系统通常注册为其他名字(如
PingFang或带版本号),且 Sublime 在 Windows 下根本无法正确调用其变体,fallback 是必然结果
Preferences → Settings – User 里怎么写才生效
必须改右侧「用户设置」面板,JSON 格式要干净,字段名一个字母都不能错。苹方作为中文字体,单独用易出问题,推荐 fallback 组合写法:
{
"font_face": "PingFang SC, Fira Code",
"font_size": 14,
"line_padding_top": 1,
"line_padding_bottom": 1
}
-
font_face值用英文逗号分隔,前面优先渲染中文,后面兜底英文和符号;别加空格("PingFang SC , Fira Code"会解析失败) - 别写
"font_face": "苹方-简"或"PingFangSC"—— 中文名、去空格、大小写错,全都会静默 fallback - 如果用了
line_padding_*却没效果,先检查是否误写了已弃用的line_spacing,它在 ST4 中完全无效
为什么改完还是 Courier New 或字体发虚
常见静默失败不是配置问题,而是链路断在更底层:
- 字体册里搜不到
PingFang SC?说明它没注册进「电脑」范围(可能只装给了当前用户),重装时务必选「安装到电脑」 - JSON 里多了一个中文逗号、少了一个双引号、末尾多了逗号——Sublime 不报错,直接放弃整段配置,退回到默认字体
- 高 DPI 屏幕下中文笔画细、边缘发虚?可临时加
"gl_hardware_acceleration": false测试,但这是权衡:关掉后滚动略卡,但中文更稳 - 想开连字?别信
"font_options": ["liga"]—— Sublime 渲染引擎根本不解析 OpenType ligature 表,填了也白填,视觉上看到的“合并”大概率是系统级缓存渲染的错觉
真正起作用的只有三件事:系统注册名抄对、JSON 写合法、Sublime 完全退出后重开。其他所有“增强”配置,比如 subpixel 抗锯齿、自定义 theme 调 UI 字体,都和编辑区的 PingFang SC 显示无关——侧边栏字体得另改主题文件,那是另一套系统。


















