Sublime Text不安装字体，所谓“不兼容”多因系统字体注册失败或配置名错误导致静默回退；它只认操作系统注册的英文全名，大小写、空格、连字符全部敏感，填错即失效，必须严格匹配字体册显示名称并刷新缓存验证。
Sublime Text 本身不安装字体，所谓“不兼容”几乎全是系统级字体注册失败或配置名写错导致的静默 fallback——它不会报错，只会默默切回 Consolas 或 Courier New。
字体名填错是最常见的“不兼容”原因
Sublime 只认操作系统注册的英文全名，大小写、空格、连字符全部敏感，填错一个字符就失效：
- Windows 下“微软雅黑”必须写成
"font_face": "Microsoft YaHei"（无空格、无短横、首字母大写） - 思源黑体简体是
"Source Han Sans CN"，不是"SourceHanSansCN"或"Source Han Sans" - Fira Code 某些版本注册名为
FiraCode-Regular，不是Fira Code；可用fc-list : family | grep -i fira（Linux/macOS）或系统字体册确认 - macOS 上
"PingFang SC"在 Windows 里无效，填了直接 fallback
Linux/macOS 装完字体却看不到？缓存没刷新
把 .ttf 文件丢进 ~/.fonts/ 或 /usr/local/share/fonts/ 不等于系统已加载——Sublime 读的是缓存后的字体数据库：
- 必须运行
fc-cache -fv（注意-v查看输出，确认目标字体出现在列表里） - 如果
fc-list | grep -i "your-font-name"无输出，说明缓存没生效或字体根本没注册成功 - macOS 双击安装时务必选“安装到电脑”，而非“仅限当前用户”，否则 Sublime 启动时拿不到字体句柄
中英混排/emoji 显示异常？靠单字体撑不住
一个字体不可能覆盖所有 Unicode 区段。中文缺 emoji、等宽字体缺汉字、旧字体缺新汉字——得用逗号分隔的 fallback 链：
- 推荐写法：
"font_face": "JetBrains Mono, Microsoft YaHei, \"Segoe UI Emoji\", \"Noto Color Emoji\"" - 顺序很重要：前面优先渲染，缺字才往后 fallback；别把
Microsoft YaHei放最前，它不含 emoji，会卡住后续链 - Windows 10/11 自带
Segoe UI Emoji，macOS 原生支持Apple Color Emoji；Linux 建议手动安装Noto Color Emoji并刷新缓存 - 若仍显示方块，右下角点编码 →
Reopen with Encoding→UTF-8，排除 BOM 或混合编码干扰
改完设置没反应？别跳过重启和验证环节
Sublime 的字体设置只在启动时读一次，且对 JSON 格式极其苛刻：
- 必须改
Preferences → Settings — User（右侧面板），左侧默认设置是只读的 - JSON 必须合法：字符串用双引号、冒号后加空格、末尾不能多逗号——哪怕多一个空格，整个
font_face字段都会被忽略 - 改完要彻底退出 Sublime：Windows 检查任务栏托盘进程，macOS 用 Activity Monitor 强杀
Sublime Text进程，否则新设置不加载 - 验证是否生效：打开设置面板，输入
font_face搜索，看右侧是否显示你填的值；再新建文件敲几个中文+emoji，观察是否还出方块
真正卡住人的地方，从来不是 Sublime 本身，而是字体在系统里“装了但没完全装上”、名字“看着像但差一个空格”、缓存“以为刷了其实没刷”。每一步都得亲手验证，而不是凭感觉推进。
