Sublime Text 侧边栏背景色须修改 Adaptive.sublime-theme 中 sidebar_container 的 layer0.tint，而非 Preferences 设置；同时需在 color scheme 中调整 sidebar_row 的 foreground 以确保文字可见。
Sublime Text 的侧边栏背景颜色不能通过设置面板直接修改，必须编辑主题文件或使用自定义 color scheme 配合 UI 主题适配——这是最常被误解的起点。
为什么修改 sidebar_background 没反应？
多数人尝试在 Preferences.sublime-settings 里加 "sidebar_background": "#2d2d2d"，但该配置项仅对极少数旧版主题（如 Default）生效；Sublime 4 默认使用 Adaptive.sublime-theme，它完全忽略此设置，转而依赖主题 JSON 文件中的 class 规则。
- 主题逻辑优先级：UI 主题文件（
.sublime-theme） > 全局 settings > color scheme -
sidebar_background在 settings 中属于“兼容性遗留字段”，不是 UI 渲染的真实控制点 - 直接改 settings 不报错，但视觉无变化——这是最典型的“以为改了，其实没生效”场景
真正生效的修改方式：编辑 Adaptive.sublime-theme
路径为：Packages/Theme - Default/Adaptive.sublime-theme（Windows/macOS/Linux 一致）。需先用 PackageResourceViewer 插件提取，或手动复制到 packages/User/ 下覆盖（推荐后者，避免升级丢失）。
找到包含 "class": "sidebar_container" 或 "class": "sidebar_row" 的 block，添加或修改 "layer0.tint"：
{
"class": "sidebar_container",
"layer0.tint": [45, 45, 45], // RGB 数组，等效 #2d2d2d
"layer0.opacity": 1.0
}
-
layer0.tint控制底色，必须是长度为 3 的整数数组，范围 0–255 -
layer0.opacity影响整体透明度，设为1.0才能完全显示纯色 - 修改后保存，无需重启，侧边栏实时刷新（若无效，检查是否改错了 class 名或路径）
配合 color scheme 避免文字看不清
只改背景色容易导致文件名文字发灰、难辨认——因为文字颜色由 color scheme 控制，而非 UI 主题。需同步调整 sidebar_row 的 foreground：
在当前使用的 color scheme（如 Monokai.sublime-color-scheme）中，查找 "name": "Sidebar row" 或类似注释块，确保 "foreground" 足够对比：
{
"name": "Sidebar row",
"scope": "text",
"foreground": "#f8f8f2" // 白色系文字，适配深色背景
}
- 如果 color scheme 没定义 sidebar 相关 scope，Sublime 会回退到 theme 内置的默认文字色，可能极淡
- 推荐用
PackageDev插件辅助 scope 检测，悬停侧边栏文字可看到实际生效的 scope 链 - 不要依赖
"sidebar_foreground"这类 settings 字段——它在 Sublime 4 中已被弃用
侧边栏定制真正的复杂点不在改哪一行，而在于 theme 和 color scheme 的职责分离：一个管容器样式，一个管文本语义色。漏掉任一环，都会出现“颜色改了但字看不见”或“字清楚了但背景还是白的”这类断层现象。
