侧边栏字体大小不能通过preferences → settings – user中的font_size修改,必须在packages/user/下创建与当前主题同名的.sublime-theme文件,添加{"class":"sidebar_label","font.size":14}规则,并执行ui: reload theme或重启生效。

侧边栏字体大小不能靠 font_size 设置
改 Preferences → Settings – User 里的 font_size 对侧边栏完全无效——它只控制编辑区文字。侧边栏字体由当前启用的 UI 主题文件(.sublime-theme)中 "class": "sidebar_label" 的 font.size 决定。
常见错误:复制粘贴网上教程,把 font.size 写进用户设置 JSON 里,保存后毫无反应。这不是你操作错了,是 Sublime 根本不读这个字段。
- 必须确认当前主题名:菜单
Preferences → Theme看显示的完整文件名(如Material-Theme.sublime-theme,注意大小写、空格、后缀) - 按
Ctrl+Shift+P→ 输入Preferences: Browse Packages…,进入User/目录 - 新建文件,**严格按主题名命名**(例如:你用的是
Ayu.sublime-theme,就建Ayu.sublime-theme) - 内容只需最小覆盖:
[{"class":"sidebar_label","font.size": 14}] - 保存后执行
Ctrl+Shift+P→UI: Reload Theme(v4.4+ 支持),或彻底退出 Sublime 再重开
sidebar_container 控制侧边栏背景色
改 Preferences → Settings – User 里的 sidebar_background 同样无效。Sublime Text 4 及以后版本压根不解析该字段。真正起作用的是主题文件中 "class": "sidebar_container" 的 layer0.tint 字段。
layer0.tint 必须是长度为 3 的整数数组,代表 RGB 值,例如 [60, 90, 60](豆沙绿)、[240, 240, 240](浅灰)。写成 #3a405a 或 rgb(58, 64, 90) 会被直接忽略。
- 在你刚创建的
xxx.sublime-theme文件中搜索"class": "sidebar_container" - 确保包含
"layer0.opacity": 1.0,否则颜色可能发灰或透明 - 修改
"layer0.tint"数组值,不要删掉其他字段(如texture或layer1) - 保存后通常秒生效;若没变,检查是否拼错 class 名,或误改了
sidebar_row而非sidebar_container
文字看不清?配色方案和 UI 主题要同步调
只改 sidebar_container 背景色,常导致文件名发灰、选中行难识别——因为文字颜色由 .sublime-color-scheme 文件单独控制,和 UI 主题是两套系统。
打开你当前用的配色方案(Preferences → Color Scheme 显示的文件名),搜索 "name": "Sidebar row" 或 "scope": "text"。确保 foreground 值与背景有足够对比度:
- 深背景(如
[40, 40, 40])配亮色文字:"#f8f8f2"或[248, 248, 242] - 浅背景(如
[240, 240, 240])配深色文字:"#333"或[51, 51, 51] - 如果配色方案里根本没有
Sidebar row定义,Sublime 会回退到主题内置默认色,可能极淡甚至不可见 - 部分第三方主题(如 Material Theme)提供
material_theme_sidebar_font_size这类开关,优先查其文档,比硬改 JSON 更稳
ui_scale 比调大 font.size 更适合高分屏
在 macOS Retina 或 Windows 高 DPI 屏上,单纯增大 font.size 会让侧边栏图标模糊、文字边缘发虚——Sublime 默认未启用亚像素渲染,放大只是拉伸像素。
ui_scale 是矢量级缩放,控制整个 UI(标签页、状态栏、右键菜单、侧边栏)统一缩放,更干净也更一致:
- 在
Preferences → Settings – User中添加:"ui_scale": 1.25(支持1.0、1.25、1.5、2.0) - 保留
font.size在 12–14 区间,避免局部失真 - 注意:某些老旧插件弹窗未适配
ui_scale,可能出现模糊或错位,此时可临时切回ui_scale: 1.0单独调试 - 别混用:
ui_scale和手动调大font.size+layer0.tint容易让界面比例失调,尤其在多显示器混合 DPI 场景下
真正容易被忽略的点:class 名在不同主题里可能不同。v4 后部分主题(如新版 Ayu 或 Material)已用 sidebar_tree 替代 sidebar_label,用 View → Developer → Show Scope Name 点击侧边栏文字,才能看到当前实际生效的 class 名——不验证就瞎改,90% 白忙活。











