主题必须放入Packages根目录而非User子目录，theme值须精确匹配.sublime-theme文件名（含大小写与连字符），color_scheme路径须以Packages/开头并完整包含.tmTheme实际路径，修改后必须彻底重启Sublime Text才能生效。
主题文件夹必须放进Packages目录，不是User子目录
手动安装时，很多人把主题文件夹直接扔进 Packages/User，结果主题在 Settings 里写了也完全不生效。Sublime 只认 Packages 根目录下的主题文件夹——User 是专门留给用户自定义配置和临时文件的，放主题包进去等于“藏起来”。
- 正确路径示例（Windows）：
C:\Users\用户名\AppData\Roaming\Sublime Text 3\Packages\ayu - 错误路径示例：
C:\Users\用户名\AppData\Roaming\Sublime Text 3\Packages\User\ayu - macOS 和 Linux 同理，别进
User子目录；用Preferences → Browse Packages打开的窗口就是根目录，直接粘贴即可
theme值必须是.sublime-theme文件名，不是文件夹名
Settings – User 里写的 "theme" 字段，值必须精确匹配主题包里那个 .sublime-theme 文件的完整文件名，包括大小写、连字符和后缀。写成文件夹名、去掉后缀、大小写错一个字母，UI 就只变一半甚至完全不变。
- 比如 ayu 主题实际文件是
ayu-dark.sublime-theme，就不能写成"ayu"或"ayu-dark" - Material Theme 的正确写法是
"Material-Theme.sublime-theme"，不是"Material Theme.sublime-theme"（空格 vs 连字符） - 用右键 → Copy Path 从主题文件上复制，比手敲更安全
color_scheme路径必须带Packages/前缀，且区分大小写
"color_scheme" 不是随便填个文件名就行，它必须是 Sublime 能解析的绝对路径格式：以 Packages/ 开头，后面跟上主题包内 .tmTheme 文件的实际位置。路径错一位、大小写差一个，配色就不会加载。
- 常见错误：
"color_scheme": "ayu-dark.tmTheme"→ 缺少Packages/前缀，无效 - 正确写法：
"color_scheme": "Packages/ayu/ayu-dark.tmTheme" - 如果主题包里
.tmTheme在子目录下（如schemes/），路径必须完整，比如Packages/Material Theme/schemes/Material-Theme.tmTheme - 不确定路径？右键点击 Color Scheme 列表里的对应项 → Copy Path
改完设置必须重启，缓存不刷新就白配
Sublime 对 UI 主题的缓存非常顽固。即使你改了 Settings – User 并保存，不重启编辑器，新主题大概率不会完整渲染——标签页可能变了，侧边栏还是旧的；状态栏颜色对不上；图标不出现。这不是配置错，是 Sublime 没重载主题资源。
- 别信“改完立刻生效”的说法，尤其装完 ayu、Material Theme 这类复杂主题时
- 重启是指彻底关闭所有 Sublime 窗口（包括后台进程），再重新打开
- macOS 上注意 Dock 图标右键退出，不是关窗口就完事
