Sublime Text中font_face必须填操作系统注册的英文全名,如Windows填"Microsoft YaHei"、macOS填"PingFang SC",填错会导致字体fallback至默认等宽字体。

Sublime Text里font_face填什么才有效
填错 font_face 是中文字体不生效的最常见原因。Sublime Text 不认中文名、不认文件名、也不认系统字体册里显示的“微软雅黑”这种名字,它只认操作系统注册的英文全名。
- Windows 上微软雅黑必须写成
"font_face": "Microsoft YaHei"(注意大小写、无空格、无“-”) - 思源黑体简体是
"font_face": "Source Han Sans CN"(CN后缀不能少,空格不能错) - 霞鹜文楷是
"font_face": "LXGW WenKai"(WenKai首字母大写,区分大小写) - macOS 苹方字体用
"font_face": "PingFang SC",Windows 填了会 fallback 到Courier New
填错最直接的表现:保存设置后字体没变,或整个编辑器突然变成等宽默认字体——这不是崩溃,是字体 fallback 失败。
字体装进系统但Sublime看不到?检查注册状态
Sublime Text 本身不安装字体,只调用系统已注册的字体。你双击 .ttf 文件点了“安装”,不等于系统就注册成功了。
- Windows:右键字体文件 → “为所有用户安装”(仅当前用户安装,Sublime 可能看不到)
- macOS:双击字体 → 点“安装字体” → 确保目标选“电脑”而非“当前用户”
- Linux:复制到
~/.fonts/或/usr/local/share/fonts/,然后运行fc-cache -fv
装完别急着开 Sublime,先打开系统字体管理工具(Windows 字体设置、macOS 字体册),确认 Microsoft YaHei 是否以英文名显示——这才是你要抄进 font_face 的名字。
修改Preferences.sublime-settings — User的正确姿势
必须改右侧 Preferences.sublime-settings — User,左侧默认设置是只读的,改了也无效。
- 确保 JSON 格式合法:大括号包裹,每行末尾不能有多余逗号
- 正确写法示例:
{ "font_face": "Microsoft YaHei", "font_size": 12 } - 想兼顾中英文效果,可加
"font_options": ["subpixel_antialias"](Windows 高 DPI 下缓解发虚) - 改完必须保存,且彻底退出 Sublime(Windows 查任务栏托盘、macOS 用 Activity Monitor 杀进程),否则新设置不加载
多字体自由切换靠的是配置组合,不是插件
Sublime Text 没有“字体切换面板”或快捷键轮换功能,所谓自由切换,本质是预设多套 font_face + font_size 组合,通过手动替换配置并重启实现。
- 比如为代码配
"font_face": "Fira Code",为中文注释配"font_face": "LXGW WenKai",但同一时间只能生效一套 - 若想快速来回切,建议建多个 JSON 片段(如存为
code-font.json/zh-font.json),复制粘贴覆盖用户设置 - 注意:部分字体(如
PingFang SC)在非 macOS 系统下会静默失效,不会报错,只会 fallback,容易误判为“切换失败”
真正容易被忽略的是:字体渲染异常(发虚、方块字)往往和 gl_hardware_acceleration 设置有关,而不是字体名或安装问题。高 DPI 屏幕下,加一行 "gl_hardware_acceleration": false 常比换字体更管用。


















