Sublime Text不安装字体，只调用系统已注册的字体全名；必须通过系统工具确认“完整名称”，严格匹配大小写、空格和连字符，填错即静默回退到默认字体。
字体必须先装进系统，Sublime 不会帮你装
Sublime Text 本身不提供任何字体安装能力，它只从操作系统已注册的字体库中读取 font_face。你双击 FiraCode-Regular.ttf、拖进 Fonts 文件夹、甚至用脚本复制过去，都不等于 Sublime 能识别——关键在「注册成功」。
常见错误现象：改完 font_face 后字体没变，或突然变成 Consolas 或 Courier New，这不是崩溃，是 fallback 失败。
- Windows：右键字体文件 → “为所有用户安装”（仅当前用户安装，Sublime 可能看不到）
- macOS：双击字体 → 点“安装字体” → 在弹出窗口中选“安装到电脑”，不是“仅我”
- Linux：复制到
~/.fonts/或/usr/local/share/fonts/，然后必须运行fc-cache -fv刷新缓存
装完别急着开 Sublime，先打开系统字体管理工具确认：Windows 是“设置 → 字体”里搜 Microsoft YaHei，macOS 是“字体册”App 中筛选“电脑”范围并点开详情看「全名」字段——这才是你要抄进配置里的名字。
font_face 必须填系统注册的英文全名，大小写空格全敏感
填错一个字符，Sublime 就静默 fallback，不会报错也不会提示。它不认中文显示名（如“微软雅黑”）、不认文件名（如 msyh.ttc）、也不认家族名（如 YaHei）。
正确示例：
- 微软雅黑 →
"font_face": "Microsoft YaHei"（Windows，无空格、无连字符） - 思源黑体简体 →
"font_face": "Source Han Sans CN"（CN 后缀不能少，空格不能错） - 霞鹜文楷 →
"font_face": "LXGW WenKai"（WenKai 首字母大写，区分大小写） - Fira Code → 有些版本注册名为
FiraCode-Regular，不是Fira Code；用fc-list : family | grep -i fira查 Linux 真实名
验证方式：在 Sublime 的 Preferences → Settings — User 右侧面板中写入后保存，彻底退出编辑器（Windows 查托盘右键“退出”，macOS 用 Activity Monitor 杀掉进程），再重开。若仍无效，大概率是名字抄错了或系统没真正注册。
配置写在哪、怎么写才合法
必须改右侧 Preferences.sublime-settings — User，左侧默认设置是只读的，改了也白改。
JSON 格式必须严格合法：
- 外层必须是大括号
{} - 键和字符串值都必须用双引号
"，不能用单引号或中文引号 - 冒号后必须有空格，比如
"font_face": "Fira Code"，不是"font_face":"Fira Code" - 最后一行不能有多余逗号，比如
"font_size": 14,会导致整个配置失效
最小可用配置示例：
{
"font_face": "Microsoft YaHei",
"font_size": 13
}
如果想启用连字（ligature），可加 "font_options": ["liga"]；Windows 高 DPI 下发虚，可加 "font_options": ["subpixel_antialias"]。
行距和 UI 字体不是一回事
line_spacing 已被弃用多年，写了也不生效。真正控制代码行视觉松紧的是 line_padding_top 和 line_padding_bottom，单位是像素，设成 1 或 2 就明显更透气。
注意：值过大（如 >5）会导致括号高亮条变细、折叠箭头偏移、光标跳行不准，尤其在深色主题下容易漏看。
侧边栏、标签页、状态栏等 UI 字体，无法通过 font_face 统一设置，必须修改当前主题文件（如 Ayu.sublime-theme），找到 class: "sidebar_label" 这类节点手动加 "font.face" 属性，改完需重启 Sublime。
最常被忽略的一点：改完所有配置后，必须彻底退出 Sublime Text 进程，否则新设置不加载——哪怕只是关掉所有窗口，后台进程仍在，缓存未清，字体照样不生效。
