必须通过developer: show scope name确认侧边栏实际class名(如sidebar_label、sidebar_file等),再在packages/user/下建同名.theme文件覆盖对应class的font.size值,最后执行ui: reload theme生效。

侧边栏字体大小不能在 Settings 里改,必须改主题文件中的 sidebar_label 规则 —— 改 font_size 或 font.size 都可能无效,关键看当前主题用的是哪个字段。
怎么确认当前主题和对应规则名
Sublime 的侧边栏样式由当前启用的主题文件决定,不是所有主题都用 sidebar_label。比如 ST4+ 的 Adaptive.sublime-theme 用的是 sidebar_label,但有些第三方主题(如旧版 Material Theme)可能用 sidebar_file 或 sidebar_heading;更晚版本甚至引入了 sidebar_tree。
最可靠的办法是:打开侧边栏任意文字,按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Developer: Show Scope Name 回车,点击侧边栏文字,看控制台输出的 class 名。常见结果包括:
-
sidebar_label(默认、Adaptive 主题) -
sidebar_file(部分 Material Theme 版本) -
sidebar_tree(ST4.4+ 某些主题)
别凭经验硬猜,Scope Name 是唯一权威依据。
在哪改、怎么改才安全不丢
直接编辑 Packages/Theme - Default/Default.sublime-theme 或 Packages/Adaptive/adaptive.sublime-theme 是高风险操作:升级后文件会被覆盖,且容易因 JSON 格式错误导致整个 UI 渲染失败(黑屏或空白)。
正确做法是走 User 覆盖路径:
- 进
Preferences → Browse Packages…,打开User/文件夹 - 新建文件,**文件名必须和你当前主题名完全一致**,例如你用的是
Adaptive.sublime-theme,就建Adaptive.sublime-theme;如果是ayu-light.sublime-theme,就建同名文件 - 内容只写你要覆盖的部分,例如:
[ { "class": "sidebar_label", "font.size": 14 } ] - 保存后执行
Ctrl+Shift+P → UI: Reload Theme,或完全退出 Sublime 再启动
这个方式不会被升级覆盖,也不会破坏原始主题结构。
font.size 还是 font_size?ST 版本和主题差异很大
不同 Sublime 版本和主题对字段名的接受度不一致:
- ST3 大多认
font.size(带点) - ST4 早期版本兼容
font.size和font_size(下划线),但部分新主题只响应font.size - 如果你发现加了
"font_size": 14没反应,立刻换成"font.size": 14重试 - 某些主题(如 Ayu)文档明确要求用
ayu_sidebar_font_size这类配置项,这时就别碰.sublime-theme,去Settings – User加字段更稳
没有“通用字段”,只有“当前主题实际解析的字段”。查 Scope Name + 看主题文档,比背口诀管用。
改完没生效?优先检查这三件事
90% 的“改了没变”问题卡在这三个地方:
- 主题文件里有多个
sidebar_labelrule(比如区分展开/折叠状态、文件/文件夹),你只改了其中一个 → 全局搜索,把所有匹配项里的font.size都设成一样 - 用了第三方主题(如 Material Theme),却去改
Default.sublime-theme→Preferences → Settings – User里搜"theme",确认值是什么,就去覆盖对应名字的文件 - Sublime 进程没彻底退出(尤其 macOS),Activity Monitor 里还有
Sublime Text进程 → 强制退出再开,别只关窗口
真正麻烦的不是改哪,而是改对了之后,它到底读没读到——UI 渲染不报错,只沉默失效。











