侧边栏字体需用系统已注册的全名配置,大小写空格连字符全敏感;须在主题文件中修改"sidebar_label"的font.face,而非Settings;等宽字体且避免主题覆盖才能正常显示。

侧边栏不能“安装”字体,只能用系统已注册的字体名去配置;填错一个字符,就 fallback 到 Consolas。
确认字体已正确注册进系统
Sublime Text 不会帮你装字体,它只读操作系统字体库。你双击安装 .ttf 文件 ≠ Sublime 能识别——它要的是注册后的「全名」,大小写、空格、连字符全敏感。
- Windows:右键字体文件 → “为所有用户安装”,然后打开「设置 → 字体」搜索确认显示为
Microsoft YaHei或JetBrains Mono(不是“微软雅黑”,也不是msyh.ttc) - macOS:双击字体 → 「安装字体」→ 打开「字体册」App → 筛选「电脑」范围 → 点击字体预览页顶部的「全名」字段(如
JetBrainsMono-Regular,不是文件名JetBrainsMonoNerdFont-Regular.ttf) - Linux:复制到
~/.fonts/或/usr/local/share/fonts/→ 运行fc-cache -fv→ 再用fc-list : family | grep -i "jetbrains"查真实 family name(带引号那行,如"JetBrainsMono Nerd Font")
在主题文件里写对 font.face 字段
Preferences → Settings – User 里的 font_face 对侧边栏完全无效。真正起作用的是当前启用的 .sublime-theme 文件中 "class": "sidebar_label" 规则下的 font.face(注意是 font.face,不是 font_face)。
- 先通过 Preferences → Theme 确认当前主题名(如
Adaptive.sublime-theme) - 按 Ctrl+Shift+P → 输入
Preferences: Browse Packages…→ 进入User/目录 → 新建同名文件(如Adaptive.sublime-theme) - 内容只需最小覆盖:
[{"class":"sidebar_label","font.face":"JetBrains Mono","font.size":13}] - 如果用了 Nerd Font 补丁版(推荐用于图标),
font.face必须填补丁版注册名,常见为JetBrainsMono Nerd Font或JetBrainsMonoNF,不能混用原版名
字体生效但文字错位?检查是否等宽 + 避免主题覆盖
侧边栏依赖等宽排版对齐图标和缩进。非等宽字体(如 Segoe UI)会导致文件名偏移、折叠箭头错位。
- 优先选明确标为「等宽」的开发字体:
Fira Code、JetBrains Mono、Source Code Pro、Victor Mono - 某些第三方主题(如
Material Theme、Ayu)会主动重写sidebar_label样式,把你写的font.face覆盖掉 - 排查方法:临时换回
Default.sublime-theme测试;或禁用插件(尤其是SideBarEnhancements)看是否恢复 - 若仍错位,加
"bold": false和"font.style": ""显式清空样式干扰
改完没反应?最常被忽略的三个点
不是配置错了,就是缓存、拼写、结构三者之一卡住了。
- 没执行
UI: Reload Theme(Ctrl+Shift+P 输入)或彻底重启 Sublime —— 主题修改不支持热更,尤其 macOS/Linux 下容易卡旧缓存 -
font.face值多一个空格、少一个连字符(如写成JetBrainsMono而非JetBrains Mono),整条 rule 就静默失效 - 主题文件里有多个
"class": "sidebar_label"(比如区分文件夹/文件/折叠态),只改了其中一个,其他仍用默认字体

















