Sublime Text 4仅支持.sublime-color-scheme和.sublime-theme两种格式，color_scheme控制编辑区配色，theme独立控制侧边栏、标签页等UI元素；确认方式为右键菜单项“Copy Path”查看后缀，路径大小写与空格必须完全匹配，且需手动重选方案或重启窗口生效。
Sublime Text 的“主题”不是单一体系，color_scheme 和 theme 必须分开配、分别生效，漏掉任一环节，UI 就会割裂——比如编辑区是豆沙绿，侧边栏还是刺眼黑。
怎么确认当前用的是 .sublime-color-scheme 还是 .tmTheme
Sublime Text 4 只加载 .sublime-color-scheme 格式；老的 .tmTheme 文件放进 Packages/User/ 也不会出现在菜单里，且不报错、不提示。
- 打开
Preferences → Color Scheme，右键已启用的方案 →Copy Path，粘贴看后缀：必须是.sublime-color-scheme - 如果路径里含空格（如
Packages/Color Scheme - Default/），大小写和空格一个都不能少 - 想安全自定义？直接用
Preferences → Customize Color Scheme，它会自动创建Packages/User/Custom.sublime-color-scheme，只写你要改的部分，其余全继承 - JSON 格式错误（比如多逗号、中文引号）会导致静默失效——编辑区退回到 Monokai，但 Sublime 不提醒
为什么改了 color_scheme，侧边栏/标签页颜色完全没变
因为 color_scheme 只控制代码编辑区（文字、括号高亮、选中背景等），而侧边栏、标签页、状态栏由独立的 theme 控制，两者路径、格式、加载机制全不相同。
- 检查当前 UI 主题：
Preferences → Theme…，如果显示的是Adaptive.sublime-theme，那它默认不设色，侧边栏就是纯黑 -
theme文件必须是.sublime-theme后缀，JSON 格式，且路径严格匹配："theme": "Packages/User/MyTheme.sublime-theme"—— 漏Packages/、大小写错（如mytheme）、斜杠方向反，全都不生效 - 改
sidebar_container才真正影响侧边栏背景：必须在.sublime-theme里找"class": "sidebar_container"，改它的layer0.tint字段（值为长度为 3 的整数数组，如[40, 50, 40]），不是十六进制 -
layer0.opacity必须设为1.0，否则tint不显色
手动改 sidebar_container 背景后文字看不清怎么办
只调背景色，不调文字色，大概率导致文件名发灰、选中行不可辨——因为文字颜色由三处解耦控制，缺一不可。
- 查当前
.sublime-color-scheme文件里是否有"name": "Sidebar row"条目；没有就加一条，明确指定"foreground"（深背景配"#f8f8f2"，浅背景配"#333"） - 在
.sublime-theme中同步检查"class": "sidebar_row"和"class": "label_control"的color或layer0.tint，确保 hover/选中态也有足够对比度 - 图标不显示？不是插件开关问题，而是
.sublime-theme里必须明确定义"class": "icon_folder"和"class": "icon_file_type"规则；"file_icons": true这类配置项 Sublime 完全不识别
路径写错、重启也不生效的排查顺序
90% 的“改了没反应”问题出在路径或大小写上，别猜，按这个顺序实锤：
- 用
Preferences → Browse Packages…打开实际Packages/目录，确认文件真正在User/下，且后缀正确（.sublime-color-scheme或.sublime-theme） - 在
Preferences → Color Scheme或Preferences → Theme…里点选你的方案，看右下角状态栏是否显示完整路径——那是 Sublime 实际加载的路径，照着抄 - 改完保存后，
color_scheme需手动重选一次才生效；theme部分变化（如树状目录背景）可能需关闭再开新窗口 - 某些插件（如 BracketHighlighter、Origami）会劫持 UI 渲染，临时禁用它们测试是否冲突
最易被忽略的一点：Sublime Text 4 不再支持 .tmTheme，但很多教程还在教改它——你花两小时调好的 XML 文件，其实根本没被加载。先确认格式，再动手，省掉大半调试时间。
