Sublime Text不安装字体，只读取系统已注册的全名（大小写、空格、连字符全敏感）；Windows查“完整名称”，macOS看“字体册→全名”，Linux用fc-list确认并fc-cache -fv刷新缓存。
Sublime Text 本身不下载、不安装任何字体——它只读取操作系统已注册的字体。所谓“适配的编程字体”，必须分两步走：先在系统里装好，再在 Sublime 设置里用对名字。
怎么确认目标字体是否已在系统注册成功
Sublime 不认文件名（FiraCode-Regular.ttf）、不认中文显示名（“微软雅黑”）、也不认字体家族名（Fira Code），只认操作系统注册表/字体册里记录的「全名（Full Name）」，且大小写、空格、连字符全部敏感。
- Windows：打开「设置 → 蓝牙和其他设备 → 字体」，搜索字体名 → 点开详情看「完整名称」字段，例如
Microsoft YaHei或FiraCode-Retina - macOS：双击字体文件 → 「显示简介」→ 查「全名」（不是「版权」或「样式」），例如
Fira Code（带空格）、JetBrains Mono - Linux：终端运行
fc-list : family | grep -i "fira"，输出中带引号的才是真实 family name，例如"Fira Code"；装完务必执行fc-cache -fv
没在这三个地方看到正确全名，Sublime 就不可能识别它——后续所有配置都静默 fallback 到 Consolas 或 Monaco。
font_face 配置写错一个字符就失效
Sublime 的 font_face 字段是严格字符串匹配，填错即退回到默认字体，且不报错、不提示。
- 别写
"font_face": "Fira Code"（macOS 下部分版本因空格失败） - 别写
"font_face": "FiraCode"（缺连字符或 Regular 后缀，常见于某些打包版） - 别写
"font_face": "Microsoft YaHei"（Windows 正确，但 macOS 上要写MicrosoftYaHei或根本不可用） - 中文字体必须放在英文连字字体之后作 fallback，例如：
"font_face": "Fira Code, Microsoft YaHei"
JSON 必须合法：字符串用双引号、冒号后加空格、末尾不能多逗号。错误配置不会报错，只会让字体“看起来没变”。
连字字体（ligature）和行距必须手动调
像 Fira Code、JetBrains Mono 这类连字字体，启用后若不调行距，!=、=> 等符号容易被上下行裁切，尤其在高 DPI 屏幕上。
- 弃用已失效的
line_spacing，改用line_padding_top和line_padding_bottom - 起手建议设为
"line_padding_top": 1, "line_padding_bottom": 1 - 值 >3 容易导致括号高亮条变细、折叠箭头偏移、光标定位跳行（尤其深色主题下易漏看）
-
font_size和line_padding_*单位都是 px，互不影响，但共同决定视觉密度
侧边栏、标签页、状态栏字体不走 font_face，得进主题文件（如 Adaptive.sublime-theme）手动改 ui_font.face 并重启生效。
Package Control 装不上，字体配置根本没机会生效
很多人卡在“点了 Install Package 没反应”“控制台没报错但列表空白”，其实是 Package Control 根本没装成——它不是插件，是整个插件系统的地基。
- ST4 用户误用 ST3 的安装脚本（哈希值不是以
6f4c264a开头）会导致命令面板能看见选项，点开却静默卡死 - 真正装成功的标志只有两个：
Ctrl+Shift+P输入Package Control: List Packages返回空列表（不是报错）；输入Package Control: Install Package左下角出现Fetching list of available packages - 公司/校园网常屏蔽
packagecontrol.io，换手机热点或开代理最有效；反复粘贴脚本不如手动下载Package Control.sublime-package文件，拖进Installed Packages/目录（不是Packages/），并清空旧残留后再重启
字体名对了、配置写了、Package Control 却没跑起来——那 Preferences → Settings 里改的全是废配置，因为用户设置文件可能根本没加载。
