Sublime Text 不支持直接安装字体，必须先在操作系统中安装并确认字体注册的英文全名，再准确填入 settings 中的 font_face 字段，否则静默回退到默认字体。
Sublime Text 下载安装完后，不能直接“安装字体”——它压根不提供这个功能。你必须先在操作系统里装好字体，并确认系统注册的全名，再填进 Sublime 的设置里，缺一不可。
字体必须先装进系统，Sublime 才可能看到
双击 .ttf 或 .otf 文件点“安装”，不等于 Sublime 就能用。它只读取操作系统字体库中已注册的字体，且只认注册时生成的「英文全名」（大小写、空格、连字符全部敏感）。
- Windows：右键字体文件 → 选“为所有用户安装”，装完去「设置 → 蓝牙和其他设备 → 字体」里搜索，点开详情看「完整名称」字段（例如
Microsoft YaHei，不是“微软雅黑”） - macOS：双击字体 → 点“安装字体”，目标选“电脑”；然后打开「字体册」App，筛选“电脑”范围，选中字体 → 右下角「信息」面板里的「完整名称」才是你要抄的（例如
PingFang SC或LXGW WenKai） - Linux：复制字体文件到
~/.fonts/或/usr/local/share/fonts/，再运行fc-cache -fv刷新缓存；之后用fc-list : family | grep -i "fira"查输出中带引号的 family name（例如"Fira Code"）
font_face 填错一个字符，就静默 fallback 到 Consolas
Sublime 的 font_face 字段是严格字符串匹配，不是模糊搜索。填错就退回到默认等宽字体，界面不会报错，也不会提醒你——你只会发现字体没变，或突然变丑了。
- 常见错误：
"Microsoft YaHei"在 macOS 上大概率失败（空格导致），应填"MicrosoftYaHei"或查系统真实注册名 - 思源黑体简体必须写成
"Source Han Sans CN"，CN后缀不能少，空格不能换成下划线 - Fira Code 某些版本注册名为
FiraCode-Regular，不是Fira Code；JetBrains Mono 可能是JetBrainsMono NL，得实查 - 填完必须保存设置，并彻底退出 Sublime（Windows 注意托盘图标右键“退出”，macOS 用 Activity Monitor 杀进程），否则新配置不加载
设置里怎么写才合法有效
打开 Preferences → Settings，只改右侧「User」面板（左侧是只读默认设置），内容必须是合法 JSON：
{
"font_face": "Microsoft YaHei",
"font_size": 13,
"line_padding_top": 1,
"line_padding_bottom": 1
}
-
font_face是唯一生效的字段，font-family、FontFace、fontsize全无效 - 字符串必须用双引号，冒号后建议加空格，末尾不能有多余逗号
- 中英文混排建议把中文字体放后面作 fallback，例如
"font_face": "FiraCode-Retina, Microsoft YaHei"（连字优先，中文兜底） -
line_padding_top/line_padding_bottom控制行距，line_spacing已弃用，写了也不起作用
为什么装了字体却还是显示方块或乱码
最常被忽略的是编码和字体能力不匹配：Sublime 默认用 UTF-8 解码文件，但如果你打开的是 GBK 编码的旧中文文件，即使字体装对了，也会显示方块。
- 先确认文件真实编码：菜单栏
File → Reopen with Encoding → GB2312或GBK试试 - 长期方案是装插件
ConvertToUTF8（通过 Package Control 安装），它能自动识别并转码非 UTF-8 文件 - 如果侧边栏、标签页字体还是难看，那是 UI 字体，得改主题文件（如
Adaptive.sublime-theme），不是改font_face能解决的 - 某些字体（如霞鹜文楷）在高 DPI Windows 上可能发虚，可加
"font_options": ["subpixel_antialias"]缓解
真正卡住人的从来不是“怎么填”，而是“填什么”——那个系统注册名，必须亲手从字体管理工具里复制出来，不能靠记忆、不能靠文件名、不能靠中文界面显示名。多花 30 秒确认这一步，后面所有调试都省了。
