Sublime Text主题和配色方案须放于Packages/ThemeName/和Packages/ColorSchemeName/目录下，启用需在用户settings中同时配置theme与color_scheme字段，且须满足版本、插件等依赖条件。
主题文件放哪里？别塞错目录
Sublime Text 的主题（.sublime-theme）和配色方案（.sublime-color-scheme）必须放在正确的用户数据目录下，否则 Preferences > Color Scheme 或 Preferences > Theme 里根本不会显示。Windows/macOS/Linux 路径不同，但统一用菜单打开最稳：Preferences > Browse Packages… —— 这个操作会直接打开 Packages/User 上一级的 Packages 文件夹（注意不是 User 子目录本身）。
正确路径结构是：
Packages/ThemeName/ThemeName.sublime-themePackages/ColorSchemeName/ColorSchemeName.sublime-color-scheme
常见错误：把 .sublime-theme 直接丢进 Packages/User/；或者解压 zip 后多套了一层文件夹（比如 Dracula-Sublime/Dracula-Sublime/Dracula.sublime-theme），导致 Sublime 找不到有效主题声明。
如何启用新主题？改 settings 不是点菜单
装好文件后，不能只靠菜单切换——很多主题（尤其是带 UI 元素的完整主题，如 ayu、Material Theme）需要同时设置 theme 和 color_scheme 两个字段，且必须写在 Preferences.sublime-settings（用户级）里，而不是默认设置中。
打开 Preferences > Settings，在右侧用户设置面板里写：
{
"theme": "ayu-dark.sublime-theme",
"color_scheme": "Packages/ayu/ayu-dark.sublime-color-scheme"
}注意点：
-
theme值必须是 .sublime-theme 文件名（含扩展名），且大小写严格匹配 -
color_scheme值必须是完整路径格式，以Packages/开头，不能用相对路径或本地文件协议 - 如果主题带多种变体（light/dark/mirage），要确保
color_scheme路径与theme名称语义一致，否则 UI 和代码区颜色可能割裂
为什么主题没反应？检查这些硬性依赖
不少流行主题（比如 Material Theme、Origami）不是纯静态资源，它们依赖额外组件或特定 Sublime 版本。没反应不一定是路径错了，很可能是卡在这几处：
- Sublime Text 版本太低：Sublime Text 4（Build 4126+）才原生支持
.sublime-color-scheme格式；旧版强行用新版配色会静默失败 - 缺少配套插件：例如
Material Theme要求先装Theme - Material包，且需运行Material Theme: Activate Theme命令（通过Ctrl+Shift+P）初始化，光改 settings 不生效 - UI 缩放干扰：某些主题对
ui_scale敏感，若设置了非 1.0 的值（如"ui_scale": 1.25），可能导致 tab 栏、侧边栏渲染异常甚至崩溃
自定义主题微调：别直接改源文件
想改一点细节（比如调整 tab 高度、缩小 sidebar 字体）？别编辑主题包里的原始 .sublime-theme 文件——下次更新包管理器会覆盖掉。
正确做法是用 Sublime 的“覆盖机制”：
- 在
Packages/User/下新建同名文件，例如ayu-dark.sublime-theme - 内容只需写你想覆盖的部分，比如：
{
"class": "tabset_control",
"settings": ["widget"],
"attributes": ["selected"],
"layer0.texture": "Packages/ayu/assets/tab-active.png"
}Sublime 会自动合并：User 目录下的同名主题文件优先级最高，只覆盖指定 key，其余继承原主题。这样既安全，又方便同步到其他机器。
真正容易被忽略的是：主题覆盖只对 class 和 key 精确匹配生效，拼错一个字母（比如 tabset_control 写成 tab_set_control）就完全无效，而且没有任何报错提示。
