改sidebar_container的layer0.tint才真正生效:必须在当前启用的.sublime-theme文件中修改"class": "sidebar_container"下的layer0.tint(三元整数数组,如[30, 30, 35])和layer0.opacity: 1.0,同时同步调整sidebar_row、label_control及color-scheme中sidebar row的foreground以确保文字可读。

改 sidebar_container 的 layer0.tint 才真正生效
Sublime Text 4 完全忽略 Preferences.sublime-settings 里的 sidebar_background,哪怕你写成 "sidebar_background": "#1e1e1e",侧边栏也纹丝不动。真正起作用的,只有当前启用的 .sublime-theme 文件中匹配 "class": "sidebar_container" 的那条规则里的 layer0.tint 字段。
这个字段必须是长度为 3 的整数数组,代表 RGB 值,范围 0–255,例如:[30, 30, 35](深灰)、[60, 90, 60](豆沙绿)。别写 #3a405a、rgb(58, 64, 90) 或任何带单位/符号的格式,主题文件会直接跳过。
-
layer0.opacity必须设为1.0,否则再改tint也显不出纯色 - 如果原主题用了
layer0.texture(比如带噪点或渐变的底图),想彻底禁用就得设为null - 别直接编辑原始主题文件(如
Packages/Adaptive/Adaptive.sublime-theme),升级后会被覆盖
同步调 sidebar_row 和 label_control 避免文字不可读
只改 sidebar_container 的背景,大概率导致文件名发灰、选中行难以识别——因为文字颜色由另一套系统控制:配色方案(.sublime-color-scheme)和 UI 主题里更细粒度的 class 规则,两者完全解耦。
你得同时检查并调整三处:
-
"class": "sidebar_row":控制每行文件/文件夹的背景(含 hover 和选中态),它的layer0.tint或layer0.opacity影响高亮对比度 -
"class": "label_control":控制文件名文字本身的颜色渲染层,它的color字段直接影响可读性 - 当前启用的
.sublime-color-scheme文件中"name": "Sidebar row"对应的foreground值,深背景配"#f8f8f2",浅背景配"#333"
如果 color scheme 里压根没定义 Sidebar row,Sublime 会回退到 theme 内置的默认文字色,可能极淡甚至不可见。
图标不显示?先确认主题是否定义了 icon_folder 和 icon_file_type
在 Preferences → Settings 里加 "file_icons": true 或 "show_folder_icons": true 是无效的——Sublime Text 根本不识别这些键名。图标能否出现,只取决于当前 .sublime-theme 文件里有没有定义 "class": "icon_folder" 和 "class": "icon_file_type" 这两类规则。
常见错误现象:
- 装了 A File Icon 插件但没图标 → 当前主题(如 Default)根本没写
icon_folder规则 - 换了 Material Theme 却没图标 → 没在用户设置里开启
"material_theme_icons_tree_view": true - 图标发灰或变色 → 主题对
icon_folder应用了layer0.tint或layer0.opacity
想换图标,不是改文件名,而是把新 PNG(尺寸必须是 16×16 或 32×32)放进主题目录,然后在 layer0.texture 字段里填相对路径,例如:"layer0.texture": "MyTheme/folder-closed.png"。
字体大小无法通过设置项调整,它硬编码在 sidebar_label 规则里
侧边栏字体大小没有对应 JSON 配置项,也不响应 font_size 全局设置。它被写死在主题文件的 "class": "sidebar_label" 规则中,靠 font.size 字段控制。
如果你发现侧边栏文字太小或太大,必须手动修改该 rule:
- 在自定义主题文件中搜索
"class": "sidebar_label" - 添加或修改
"font.size": 12(数值按需调整) - 注意:某些主题把
sidebar_label和label_control合并在一条 rule 里,要一起看
改完保存后,执行 UI: Reload Theme(Ctrl+Shift+P 输入)即可实时预览,不用重启软件。但别漏掉 label_control 的 color,否则字可能糊在背景上。











