sublime text不安装字体,必须先在系统中安装并注册字体,再用系统字体册显示的全名(大小写、空格敏感)配置font_face;侧边栏等ui字体需修改主题文件并重启生效。

字体必须先装进系统,Sublime 不会帮你装
Sublime Text 本身不提供任何字体安装能力,它只读取操作系统字体册(Font Registry)里已注册的等宽字体。你双击 Fira Code.ttf、拖进「字体设置」或复制到 ~/.fonts/,都不等于 Sublime 能用——关键在系统是否把它注册为一个可用的「全名」。
常见静默失败现象:改完 "font_face": "Fira Code" 后毫无变化,界面仍显示 Consolas 或 Courier New;打开系统字体管理工具却搜不到该字体名。
- Windows:右键字体文件 → 选「为所有用户安装」(别点「仅当前用户」,某些 Sublime 版本读不到)
- macOS:双击字体 → 点「安装字体」→ 打开「字体册」App → 左下角切换为「电脑」范围 → 搜索确认显示名为
Fira Code(不是FiraCode-Regular,也不是带括号的变体) - Linux(Ubuntu/Debian):复制字体文件到
~/.fonts/或/usr/local/share/fonts/→ 终端运行fc-cache -fv刷新缓存 → 再用fc-list : family | grep -i "fira"验证输出中是否含带引号的"Fira Code"
font_face 必须填系统注册的全名,大小写空格全敏感
Sublime 的 font_face 字段不认文件名、不认中文显示名、不认缩写,只认操作系统注册时写的「全名(Full Name)」。填错一个字符,就 fallback 到默认字体,且无任何错误提示。
验证方式很简单:打开系统字体册(Windows 设置 → 字体 / macOS 字体册 / Linux 的 fc-list 输出),找到目标字体,看「全名」字段——那个字符串就是你要抄进 Sublime 设置里的值。
- 微软雅黑 → 填
"Microsoft YaHei",不是"微软雅黑"、"msyh.ttc"或"microsoft yahei" - 思源黑体简体 → 填
"Source Han Sans CN"(注意空格和CN后缀) - 霞鹜文楷 → 填
"LXGW WenKai"(WenKai首字母大写,小写无效) - Fira Code 某些版本注册为
"FiraCode-Regular",那就得写这个,不能硬套"Fira Code"
编辑区 vs 侧边栏:字体设置完全两套系统
很多人改完 font_face 发现代码区变了,但左侧文件树还是小得费眼——这不是配置没生效,是 Sublime 根本就没设计让侧边栏读这个字段。编辑区字体由 font_face + font_size 控制;侧边栏(Sidebar)、标签页、状态栏等 UI 元素,走的是主题渲染路径,必须改 .sublime-theme 文件。
直接在用户设置里加 sidebar_font_size 或类似字段,Sublime 会默默忽略,不报错也不生效。
- 编辑区:改
Preferences → Settings – User,JSON 格式写对即可,保存即刻生效 - 侧边栏:需定位当前启用的主题文件(通常在
Packages/User/或Packages/Theme - Default/),搜索"sidebar_font_size"或"font.size"类关键词,手动添加或修改,并**重启 Sublime** 才能生效 - 别试图用数组写法如
"font_face": ["Microsoft YaHei", "Fira Code"]让侧边栏也受益——它不支持这种 fallback
连字和中英混排要配对处理,单加配置大概率失效
像 Fira Code、Cascadia Code 这类连字字体,光写 "font_options": ["liga"] 是不够的。Sublime 还得确认该字体文件本身包含 OpenType 连字表,而这个信息依赖于系统级字体解析是否完整。
中文字体单独设一个英文编程字体(如 "Fira Code")会导致中文注释/字符串显示为方块,因为纯英文等宽字体基本不含中文 glyph。
- 连字验证:输入
!= == => && ||,看是否合并显示;若没变化,优先重装字体(推荐 v6.2+ 完整版),再检查配置 - 中英混排建议用双字体方案:
"font_face": "Microsoft YaHei, Fira Code"(英文逗号分隔),让系统按字符 Unicode 区间自动回退 - 某些旧版中文字体(如未更新的
YaHei Consolas Hybrid)在 Sublime Text 4 中可能被跳过,因默认禁用了部分旧渲染路径 - 改完设置后务必关闭所有 Sublime 窗口(包括托盘进程),再重开——它不热重载字体配置
最常被跳过的环节是:装完字体没去系统字体册确认全名是否显示正确,就急着写配置;或者 Linux/macOS 下漏了 fc-cache -fv;又或者把侧边栏字体当成编辑区一起配,结果白调半天。这些链路一断,Sublime 就静默 fallback,你根本看不到报错。











