Sublime识别主题文件需放至特定Packages目录：Windows为Packages/Theme-xxx/，macOS为~/Library/Application Support/Sublime Text/Packages/Theme-xxx/，Linux为~/.config/sublime-text/Packages/Theme-xxx/；启用主题须在用户设置中正确配置"theme"键并指定带.sublime-theme后缀的完整文件名。
主题文件放哪里才被 Sublime 识别
Sublime 不会自动扫描任意目录下的主题文件，必须放在特定路径下才能生效。放错位置是“明明下载了主题却找不到”的最常见原因。
- Windows：
Packages/User/或Packages/Theme - xxx/（推荐后者，避免和插件配置混在一起） - macOS：
~/Library/Application Support/Sublime Text/Packages/Theme - xxx/ - Linux：
~/.config/sublime-text/Packages/Theme - xxx/
注意：Packages 是 Sublime 自己管理的目录，不是你手动建的“随便一个文件夹”。用菜单 Preferences → Browse Packages… 打开的才是正确位置。直接往 Installed Packages/ 里扔 .sublime-package 文件也无效——那是压缩包存放地，主题得解压进 Packages/ 下的独立文件夹。
如何在设置里正确启用主题（不是配色方案）
很多人把 color_scheme 和 theme 搞混：前者只改文字颜色，后者才改侧边栏、标签页、按钮等整个 UI 样式。启用主题必须改 theme 这个键。
- 打开 Preferences → Settings，左右分屏编辑
- 在右侧用户设置里加这一行（以
ayu为例）："theme": "ayu-dark.sublime-theme" -
.sublime-theme后缀不能省，且文件名必须和你放进Packages/的文件完全一致（大小写、连字符都算） - 如果主题带多套变体（如 light/dark/mirage），要确保对应文件存在，比如
ayu-mirage.sublime-theme
改完保存，Sublime 会立刻刷新 UI。如果没反应，大概率是文件名拼错了，或主题依赖的图标集（icon_theme）没一并配置。
主题不生效？先检查这些隐藏依赖
现代 Sublime 主题常依赖额外资源，缺一不可。光丢一个 .sublime-theme 文件进去，大概率白忙活。
- 图标主题（
icon_theme）：很多主题（如Material Theme）要求同时设置"icon_theme": "Material Theme/Material-Theme.sublime-theme" - UI 字体缩放（
ui_font_size）：某些主题默认按 12px 设计，你设了14可能导致按钮错位 - Sublime 版本兼容性：Sublime Text 4 的主题语法和 ST3 不完全兼容。ST4 用户遇到
error parsing theme，基本是用了 ST3 专属主题 - 冲突项：检查是否同时启用了多个主题相关插件（如
Theme Selector），它们可能覆盖你的手动设置
最稳的排查法：临时清空用户设置，只留 "theme" 一行，确认基础功能；再逐步加回其他项，定位冲突源。
自定义主题时为什么改了 JSON 却没效果
Sublime 主题本质是 JSON 格式的 UI 规则描述，但它的加载逻辑很“挑”——不是所有字段改了都实时生效，也不是所有修改都会被解析。
- 必须用双引号包裹所有 key 和 string 值，
{'class': 'tabset'}会直接报错，得写成{"class": "tabset"} - 层级嵌套错一层（比如该在
rules数组里写的 rule 写到了顶层），整个主题文件会被跳过 - Sublime 缓存了主题解析结果，改完 JSON 后不重启或不触发 UI 刷新（比如切一下 tab），变化不会出现
- 调试建议：在
rules里加一条强制高亮规则，例如{"class": "tabset", "layer0.tint": [255, 0, 0, 32]}，看是否变红——能红说明路径和语法对了
真正难的不是写规则，而是理解 Sublime 的 UI 组件命名体系（tabset、sidebar_container、mdpopups 等），它不公开文档，只能靠反复查看默认主题或用 View Package File 反向扒。
