sublime text 不支持一键安装字体，必须先在系统中正确安装并注册字体，再在设置中用操作系统识别的全名（大小写敏感）配置 font_face；linux/macos 需刷新字体缓存，否则配置无效。
Sublime Text 本身不提供“一键安装字体”功能——它只读取系统已注册的字体，任何所谓“一键安装”本质都是帮你完成系统级字体安装 + 配置写对两步，缺一不可。
怎么确认字体是否真的装进了系统
Sublime 不认文件名（比如 FiraCode-Regular.ttf），也不认中文显示名（比如“微软雅黑”在控制面板里显示为“微软雅黑”，但 Sublime 要的是 Microsoft YaHei）。它只认操作系统注册的「全名（Full Name）」，且大小写、空格、连字符全部敏感：
- Windows：打开「设置 → 蓝牙和其他设备 → 字体」，搜索字体名，点开详情看「完整名称」字段
- macOS：双击字体文件 → 「显示简介」→ 查「全名」（不是「版权」或「样式」）
- Linux：终端运行
fc-list : family | grep -i "fira"，输出中带引号的才是真实 family name，例如"Fira Code"
装完别急着开 Sublime，先用系统自带字体工具确认名字是否显示正确；否则后续所有配置都静默失效。
Sublime 设置里 font_face 怎么写才生效
必须写在 Preferences → Settings 右侧（User）面板，JSON 格式合法，字段名一个字母都不能错：
- 单字体写法：
"font_face": "Microsoft YaHei"（注意引号、冒号、逗号） - 中英混合推荐写法：
"font_face": "Microsoft YaHei, Fira Code"（英文逗号分隔，优先用前者渲染中文，后者兜底英文和符号） - 不要写成
"font_face": "微软雅黑"或"font_face": "microsoft yahei"——大小写/中文名全错 - Linux/macOS 若装了
~/.fonts/下的字体，务必运行fc-cache -fv刷新缓存，否则 Sublime 看不见
为什么改了设置还是显示方块或默认字体
常见静默失败原因不是 Sublime 问题，而是底层链路断了：
- 字体文件没真正安装（比如 macOS 双击后只点了「仅限当前用户」，其他应用包括 Sublime 就看不到）
-
font_face值多了一个空格、少了一个引号，或用了中文标点，JSON 解析失败后直接 fallback 到默认字体 - 用了非等宽字体（如
SimSun）但没配"font_options": ["no_antialias"]，某些系统下中文渲染发虚或错位 - Sublime Text 4 默认禁用部分旧字体渲染路径，若用老版本字体（如未更新的
YaHei Consolas Hybrid），可能被跳过
想省事？这几个组合可直接抄
以下是在主流系统验证过的常用组合（请先按上文确认字体已装好）：
- Windows 中文开发：
"font_face": "Microsoft YaHei, Fira Code" - macOS 中文+编程：
"font_face": "PingFang SC, Fira Code"（注意是PingFang SC，不是PingFang） - Linux 统一等宽：
"font_face": "Noto Sans CJK SC, Fira Code"（需先sudo apt install fonts-noto-cjk或手动装）
真正卡住的永远不是 Sublime 设置那几行 JSON，而是字体有没有进系统、名字对不对、缓存刷没刷——这三个点漏掉任何一个，配置就白写。
