Sublime Text 4 侧边栏背景色必须通过修改当前 UI 主题文件（.sublime-theme）中 "class": "sidebar_container" 的 layer0.tint（RGB 数组）设置，而非 Preferences 设置；同时需同步调整 sidebar_row、label_control 及配色方案中 "Sidebar row" 的 foreground 值以确保文字可读。
侧边栏背景色不能靠 Preferences.sublime-settings 改
Sublime Text 4 的侧边栏背景色压根不读 sidebar_background 这类设置项——哪怕你写进 Preferences → Settings – User 也完全无效。它只认当前启用的 UI 主题文件（.sublime-theme）里对 "class": "sidebar_container" 的定义。
常见错误现象：改完 "sidebar_background": "#2d2d2d" 发现一点反应没有，或者颜色变灰、发暗、甚至整个侧边栏变透明——那基本就是误改了配置层级，或主题根本没加载你的设置。
- 先确认当前用的主题名：菜单
Preferences → Theme看显示的是什么（别凭印象，默认是Adaptive.sublime-theme，但可能早被你手动切成了Material-Theme.sublime-theme） - 去
Preferences → Browse Packages…找到对应主题所在目录（比如Packages/Adaptive/或Packages/Material Theme/） - 把原
.sublime-theme文件复制一份到Packages/User/目录下，重命名如MySidebar.sublime-theme，再编辑它
改 sidebar_container 的 layer0.tint 才真正生效
layer0.tint 是控制侧边栏底色的核心字段，格式必须是长度为 3 的整数数组，代表 RGB 值，例如 [40, 40, 40] 是深灰，[240, 240, 240] 是浅灰。别写 #3a405a、rgb(58, 64, 90) 或 rgba()，主题文件直接忽略。
容易踩的坑：只改背景色，结果文件名看不清、选中行难识别——因为文字颜色由配色方案（.sublime-color-scheme）单独控制，和 UI 主题是两套系统。
- 搜索
"class": "sidebar_container"，找到类似这段：{ "class": "sidebar_container", "layer0.tint": [40, 40, 40], "layer0.opacity": 1.0 } - 把
layer0.tint改成你要的 RGB 数组，比如豆沙绿：[60, 90, 60] - 保存后不用重启，侧边栏通常秒变；如果没变，检查是否拼错了
class名，或误改了sidebar_row而非sidebar_container
同步调 sidebar_row 和 label_control 避免文字失效
光有背景色不够。用户最常点的是文件/文件夹行，选中态是否清晰、文字是否可读，直接影响操作效率。而这些都依赖另外两个规则：sidebar_row 控制行背景（含选中态），label_control 控制文件名文字色。
使用场景：深色背景配浅色字，浅色背景配深色字。若不匹配，会出现文字“发灰”“融进背景”“选中后反而看不见”等问题。
- 在同一个
.sublime-theme文件里搜索"class": "sidebar_row"，添加或修改"attributes": ["selected"]分支来定义选中高亮色：{ "class": "sidebar_row", "attributes": ["selected"], "layer0.tint": [70, 120, 200] } - 搜索
"class": "label_control"并带"parents": [{"class": "sidebar_tree"}]的规则，确保"color"值对比足够，例如深背景配[240, 240, 240]（类白），浅背景配[51, 51, 51]（类黑）
别漏掉配色方案里的 "Sidebar row" 规则
很多用户改完主题文件发现文字还是不对，问题往往出在配色方案（.sublime-color-scheme）里。这个文件控制所有文本渲染，包括侧边栏文字，它的优先级高于主题文件中的 label_control.color。
性能影响：改错这里不会卡顿，但会导致整个侧边栏文字统一发灰或反色，排查时容易绕远路。
- 打开你正在用的配色方案文件（比如
Monokai.sublime-color-scheme），路径通常在Packages/Color Scheme - Default/或第三方主题目录下 - 搜索
"name": "Sidebar row"或"scope": "text"，找到对应块 - 确保其中
"foreground"值与你的新侧边栏背景形成足够对比，例如："foreground": "#f8f8f2"
改侧边栏不是调一个值的事，它横跨主题文件 + 配色方案两个独立系统，且任一环节写错格式（比如用了十六进制色值）、路径不对、class 名拼错，都会让效果完全不出现——最常被忽略的，其实是配色方案里那条 "Sidebar row"。
