Sublime Text字体安装失败主因是系统字体未正确安装或配置错误。Windows需“为所有用户安装”，macOS应选“电脑”而非“当前用户”，Linux须执行fc-cache -fv；font_face值须严格匹配系统注册的英文全名且大小写、空格、连字符准确；中英混排需用数组指定回退链；修改后须彻底退出Sublime（含托盘/后台进程）才能生效。
Sublime Text字体安装失败有哪些常见原因
Sublime Text 本身不安装字体，只读取系统已注册的字体名称。所谓“字体安装失败”，90% 是系统级安装没到位或配置写错，不是 Sublime 的问题。
系统字体没真正安装成功
双击 .ttf/.otf 文件点“安装”，不等于字体已被系统注册。不同平台有明确失败路径：
- Windows：右键安装时选了“仅当前用户”，Sublime（尤其以服务方式运行时）可能看不到；应选“为所有用户安装”
- macOS：双击安装后目标选了“当前用户”而非“电脑”，字体册里能看见，但 Sublime 启动时加载不到
- Linux：字体复制到
~/.fonts/后没运行fc-cache -fv，fc-list查不到，Sublime 就完全无视该字体
验证方式统一：打开系统自带字体管理工具（Windows 字体设置、macOS 字体册、Linux 终端 fc-list :family | grep -i "xxx"），确认显示的是英文全名（如 Microsoft YaHei），且能预览中文字符——这才是 Sublime 能用的字体。
font_face 值拼写错误或大小写不匹配
Sublime 对 font_face 值大小写、空格、连字符全部敏感。填错一个字符就静默 fallback 到 Courier New。
- 错例：
"font_face": "microsoft yahei"（全小写）、"font_face": "微软雅黑"（中文名）、"font_face": "SourceHanSansCN"（缺空格） - 对例：
"font_face": "Microsoft YaHei"、"font_face": "Source Han Sans CN"、"font_face": "LXGW WenKai" - 特别注意 macOS/Linux：
fc-list输出带引号的 family 名才是真实值，比如"Fira Code"≠Fira Code（无引号时可能被 shell 截断）
中英混排时单字体硬扛导致显示异常
很多编程字体（如 Fira Code、JetBrains Mono）不含中文字形。只配一个英文名，中文必然显示方块或悄悄 fallback 到未知字体，造成字号/行高错乱。
- 正确做法是用数组声明回退链：
"font_face": ["Fira Code", "Noto Sans CJK SC"] - 顺序很重要：从左到右匹配字符，英文优先用
Fira Code，遇到中文才切到Noto Sans CJK SC - 别信“支持中文”的宣传语——下载后务必用字体工具（如 Font Book 或
fontvalidator）检查是否真含 GB2312/Unicode CJK 区间字形
最常被忽略的一点：改完设置后没彻底退出 Sublime（Windows 要关托盘进程，macOS 要在 Activity Monitor 杀掉 Sublime Text 进程），新配置根本不会加载。字体名再对也没用。
