必须修改当前启用的.sublime-theme文件中"class": "sidebar_container"的layer0.tint（三元整数数组）并设layer0.opacity为1.0，同时同步调整color-scheme中"sidebar row"的foreground值，才能生效；改preferences.sublime-settings里的sidebar_background完全无效。
sidebar_container 的 layer0.tint 才真正控制侧边栏背景色，改 Preferences.sublime-settings 里的 sidebar_background 完全无效。
怎么改侧边栏背景色才生效
Sublime Text 4 的侧边栏背景不读任何用户设置项，只认当前启用的 .sublime-theme 文件中对 "class": "sidebar_container" 的定义。常见错误是改了 Preferences → Settings – User 里的 "sidebar_background": "#2d2d2d"，结果毫无反应。
- 先确认当前主题名：菜单
Preferences → Theme看显示的是什么（别凭印象，默认可能是Adaptive.sublime-theme，但可能早已切换） - 用
PackageResourceViewer插件提取原主题：Ctrl+Shift+P →PackageResourceViewer: Open Resource→ 选Theme - Default→Adaptive.sublime-theme - 把整个 JSON 数组复制出来，粘贴到
Packages/User/MySidebar.sublime-theme（注意路径是User/，不是原始目录） - 在新文件里搜索
"class": "sidebar_container"，找到后修改layer0.tint字段——必须是长度为 3 的整数数组，例如[40, 40, 40]（深灰）、[60, 90, 60]（豆沙绿），不能写#3a405a或rgb(58, 64, 90) - 确保
layer0.opacity是1.0；如果主题用了layer0.texture，想纯色就得设为null
为什么文字看不清？配色方案和 UI 主题要分开调
只改 sidebar_container 的背景色，大概率导致文件名发灰、选中行难识别——因为文字颜色由 .sublime-color-scheme 单独控制，和 UI 主题完全解耦。
- 打开你正在用的配色方案文件（如
Monokai.sublime-color-scheme） - 搜索
"name": "Sidebar row"或"scope": "text"相关块，确保foreground值对比足够：深背景配"#f8f8f2"，浅背景配"#333" - 如果 color scheme 里根本没定义 sidebar 相关 scope，Sublime 会回退到 theme 内置的默认文字色，可能极淡甚至不可见
- 还要同步检查
"class": "sidebar_row"和"class": "label_control"规则，它们分别控制行背景和文字渲染层
怎么调侧边栏字体大小
侧边栏字体大小无法通过设置项调整，它硬编码在主题文件的 sidebar_label 规则里。
- 在你新建的
MySidebar.sublime-theme中搜索"class": "sidebar_label" - 添加或修改
"font.size": 13（数值按需调整，12–14 是常用区间） - 注意：有些主题有多个
sidebar_label规则（比如区分折叠状态、文件夹/文件），需逐个检查 - 改完后必须在
Preferences → Theme中手动选择你保存的新主题名（如MySidebar.sublime-theme）才能生效 - 如果没变化，执行 Ctrl+Shift+P →
UI: Reload Theme；部分版本需重启软件
图标不显示？插件 + 主题双条件缺一不可
装了 A File Icon 却没图标，大概率是因为当前主题（如 Default.sublime-theme 或 Adaptive.sublime-theme）根本不支持图标渲染。
- 必须换一个自带图标规则的主题，比如
Material-Theme.sublime-theme或ayu-dark.sublime-theme - 在
Preferences → Settings – User中确认"theme"值正确，并且该主题的图标开关已启用（如 Material Theme 需"material_theme_icons_tree_view": true） - 冷门后缀（如
.env、.tf）需手动映射图标名：{"file_extensions": {"env": "gear"}}—— 右值必须是插件文档列出的图标名，拼错就 fallback 成空白文档图标 - 改完配置后，已打开的侧边栏不会实时刷新，需关闭再重开项目，或执行
A File Icon: Rebuild Icons
真正容易被忽略的是：所有改动都依赖「主题文件加载路径正确 + 配色方案显式覆盖 + 图标类名与 theme 规则精准匹配」三者同时成立。少一个，就会出现“改了但没变”“变了一半”“图标出来了字看不清”这类断层现象。
