Sublime Text不安装字体，必须先系统级安装并注册，再用系统注册的全名（如"Microsoft YaHei"）在Preferences→Settings（User）中正确配置font_face；大小写、空格、标点须完全匹配，Linux/macOS需运行fc-cache -fv刷新缓存，且改完设置须彻底退出Sublime才能生效。
Sublime Text 本身不安装字体，你点“一键安装”或拖进编辑器，它根本不会理——必须先让操作系统认下这个字体，再用系统注册的全名填进 font_face，两步缺一不可。
怎么确认字体真被系统装好了
别信文件名、别信中文显示名、别信双击安装成功的弹窗。Sublime 只读取系统字体库里的「注册全名」，大小写、空格、连字符全部敏感：
- Windows：打开「设置 → 蓝牙和其他设备 → 字体」，搜索字体名，点开详情看「完整名称」字段（比如微软雅黑是
Microsoft YaHei，不是微软雅黑） - macOS：双击字体文件 → 「显示简介」→ 查「全名」（不是「版权」或「样式」；比如霞鹜文楷是
LXGW WenKai，不是霞鹜文楷） - Linux：终端运行
fc-list : family | grep -i "fira"，输出中带引号的才是真实 family name，例如"Fira Code"
没在系统字体管理工具里看到这个英文全名，后续所有配置都静默失效。
font_face 值怎么写才不 fallback 到默认字体
font_face 必须写在 Preferences → Settings 右侧（User）面板，JSON 格式合法，一个字母都不能错：
- 单字体写法：
"font_face": "Microsoft YaHei"（注意双引号、冒号后空格、末尾无多余逗号） - 中英混合推荐写法：
"font_face": "Fira Code, Microsoft YaHei"（英文逗号分隔，优先用前者渲染英文/符号，中文 fallback 到后者） - 别写成
"font_face": "微软雅黑"或"font_face": "microsoft yahei"——大小写、中文名、空格全错 - Linux/macOS 若把字体复制到
~/.fonts/，必须运行fc-cache -fv刷新缓存，否则fc-list都查不到，Sublime 更看不到
为什么改完设置还是显示方块或默认字体
这不是 Sublime 的 bug，而是底层链路断了：
- 字体文件只点了「仅当前用户安装」（Windows/macOS），其他应用包括 Sublime 就看不到
-
font_face值多了一个空格、少了一个引号、用了中文逗号，JSON 解析失败后直接 fallback 到默认字体 - 用了非等宽字体（如
SimSun）但没配"font_options": ["no_antialias"]，某些系统下中文渲染发虚或错位 - Sublime Text 4 默认禁用部分旧字体渲染路径，比如未更新的
YaHei Consolas Hybrid可能被跳过
最常被忽略的一点：改完设置后没彻底退出 Sublime（Windows 要关任务栏托盘图标，macOS 要用 Activity Monitor 杀进程），新配置压根没加载。
