sublime text 字体设置需先将字体安装并注册到系统,再严格按系统注册名(如“microsoft yahei”)配置 font_face;行距用 line_padding_top/bottom 而非已弃用的 line_spacing;侧边栏等 ui 字体须修改主题文件并重启生效。

字体必须先装进系统,Sublime 不会帮你装
Sublime Text 本身不安装任何字体,它只从操作系统字体库中读取已注册的字体名。你直接双击 Microsoft YaHei.ttf 或拖进系统,不等于 Sublime 就能识别——它要的是注册进系统后的“正式名称”,比如 Windows 下是 Microsoft YaHei,不是“微软雅黑”,也不是 msyh.ttc。
- Windows:右键字体文件 → “为所有用户安装”,装完打开“设置→字体”确认是否显示为
Microsoft YaHei - macOS:双击字体 → 点“安装字体” → 在“字体册”App 中筛选“电脑”范围,确认显示名为
Helvetica Neue或STHeiti Light这类英文全名 - Linux:复制到
/usr/local/share/fonts/或~/.fonts/,再运行fc-cache -fv刷新缓存,否则fc-list | grep -i yahei查不到
font_face 填错一个字符,就 fallback 到 Consolas
Sublime 的 font_face 字段严格匹配系统注册名,大小写、空格、连字符都不能错。填 "Microsoft YaHei"(带空格)在 macOS 上大概率失败;填 "YaHei" 或 "microsoftyahei" 也无效;某些 Fira Code 版本注册名为 FiraCode-Regular,不是 Fira Code。
- 打开系统字体册(Windows 字体设置 / macOS 字体册),找到目标字体,看“全名”字段——那就是你要填的
font_face - 在 Sublime 的
Preferences → Settings右侧 User 面板中,写成:{"font_face": "Microsoft YaHei", "font_size": 14} - 别写
fontsize、font-size、FontFace—— 只有font_face有效 - JSON 必须合法:末尾不能多逗号,字符串必须用双引号,冒号后要有空格
行距不是 line-spacing,是 line_padding_top/bottom
网上很多教程还在教设 line_spacing,但它在 Sublime Text 3/4 中早已被弃用,写了也不生效。真正控制代码行视觉松紧的是 line_padding_top 和 line_padding_bottom,它们给每行文字上下加固定像素空白。
- 默认都是
0,设成2或3就明显更透气 - 值过大(如 >5)会导致括号高亮条变细、折叠箭头偏移、光标跳行不准,尤其在深色主题下容易漏看
- 连字字体(如 Fira Code)建议起手配
"line_padding_top": 1, "line_padding_bottom": 1,避免 != 符号被裁切 -
font_size是字号,line_padding_*是额外留白,两者单位都是 px,但互不影响
侧边栏和标签页字体得改主题文件,不是改 settings
font_face 和 font_size 只作用于编辑区文本,对侧边栏、标签页、状态栏完全无效。这些 UI 元素由当前启用的主题(如 Adaptive.sublime-theme)控制,必须手动修改对应 .sublime-theme 文件。
- Preferences → Browse Packages… → 进入
Theme - Adaptive/(或你当前主题目录)→ 找到Adaptive.sublime-theme - 搜索
"class": "sidebar_label",在其对应 rule 里加:"font.face": "Segoe UI", "font.size": 12
- 同样处理
"class": "tab_label"和"class": "status_bar" - 改完保存,**必须重启 Sublime** 才生效——这点和编辑区设置完全不同
字体名大小写、系统缓存、主题文件路径、重启要求——这些点分散在不同环节,任一遗漏都会导致“明明设置了却没变化”。调优不是一次配完就结束,而是对照系统字体册、实时验证 JSON、逐层排查 UI 渲染路径。











