Sublime Text主题拖入Packages目录后不生效，主因是文件夹名、路径、大小写或后缀未严格匹配，且必须在Settings–User中手动配置正确"theme"和"color_scheme"字段并彻底重启。
直接拖进Packages目录后不生效？检查文件夹名和路径是否严格匹配
别人分享的皮肤通常是一个压缩包，解压后得到的是一个文件夹。Sublime Text 不会自动识别任意名字的文件夹——它只认特定命名规则下的 .sublime-theme 和 .tmTheme 文件，且必须放在正确位置。
- 打开
Preferences → Browse Packages，看到的路径就是你的Packages/目录（Windows 在%APPDATA%\Sublime Text 4\Packages\，macOS 在~/Library/Application Support/Sublime Text 4/Packages/） - 把解压后的整个文件夹（不是里面的内容）拖进去，**文件夹名必须和主题作者说明的一致**：比如作者说“用
Soda Dark 3.sublime-theme”，那文件夹名就得是Theme - Soda，不能是soda-theme或Soda-Theme-main - 进该文件夹确认存在两个关键文件：
Soda Dark 3.sublime-theme（UI 主题）和Soda Dark.tmTheme（配色），缺一不可 - 如果文件夹里只有
.sublime-color-scheme（ST4 新格式），而你用的是 ST3，或反过来，也会静默失败
Settings – User 里怎么写 theme 和 color_scheme 才不白配
装完只是把文件放对地方，真正启用靠的是 Preferences → Settings – User 里的两行配置。错一个字符，Sublime 就当没这回事，还不会报错。
-
"theme"的值必须是.sublime-theme文件的**完整文件名**，包括大小写、空格、连字符和后缀：例如"Soda Dark 3.sublime-theme"，不是"SodaDark3"，也不是"Soda Dark 3" -
"color_scheme"的值必须以Packages/开头，后面跟**相对路径**：例如"Packages/Theme - Soda/Soda Dark.tmTheme"；漏掉Packages/，编辑区就回退成纯黑底 - 路径中的斜杠一律用正斜杠
/，Windows 用户别写成反斜杠\ - 如果主题作者提供了多个变体（如
ayu-mirage.tmTheme和ayu-light.tmTheme），确保color_scheme指向你想要的那个文件名，而不是文件夹
为什么菜单里选了主题但侧边栏/编辑区颜色还是不对
这是最常被忽略的割裂点：UI 主题（theme）管标签页、侧边栏、状态栏；配色方案（color_scheme）只管编辑区语法高亮和背景。两者不配套，就会出现“编辑区是暗色，侧边栏惨白”这种视觉疲劳组合。
- 先确认当前生效的 UI 主题：按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入UI: Select Theme，看带 ✔️ 的那一行是什么 - 再确认配色方案：同样调出命令面板，输入
Color Scheme，看右下角状态栏显示的完整路径，复制出来对比你写的color_scheme值 - 常见错误：用了 Solarized Dark 配色，但
theme还是默认的Adaptive.sublime-theme（它不定义侧边栏颜色，结果侧边栏纯黑或纯白） - 解决办法：要么换一个配套的 UI 主题（如
Material-Theme.sublime-theme），要么手动改Adaptive.sublime-theme对应的配置项（不推荐，容易崩）
重启是硬性要求，缓存不刷，改了也白搭
Sublime Text（尤其是 ST4）对 UI 缓存非常顽固。改完 Settings – User 后不重启，90% 的修改都不会体现——你可能以为配置错了，其实是旧样式还卡在内存里。
- 哪怕只是改了一个字母，也必须完全退出 Sublime Text（Mac 上要关掉 Dock 图标，Windows 要在任务管理器里确认进程结束），再重新打开
- 如果重启后仍无效，打开命令面板输入
Package Control: List Packages，确认主题包确实已加载；没列出，说明文件夹放错位置或名字有隐藏空格 - 临时排查可删掉
Settings – User里其他无关字段（如"font_face"、"ignored_packages"），只留"theme"和"color_scheme"，排除 JSON 格式错误干扰
真正卡住人的从来不是下载或解压，而是路径里一个空格、大小写拼错、少写一个 Packages/，或者忘了重启。这些细节不显眼，但 Sublime 一点不宽容。
