Sublime Text主题生效需theme与color_scheme同时配置且路径完全正确；二者缺一或大小写、空格、后缀、Packages/前缀任一出错，均静默回退默认界面，必须完全退出进程并重启才能刷新缓存。
theme 和 color_scheme 必须同时存在且路径全对
Sublime Text 不会报错，但只要 theme 或 color_scheme 缺一个、路径错一位、大小写/空格/后缀差一点，就静默退回默认白灰界面。这不是主题坏了，是你写的配置没被读到。
-
theme的值必须是完整的.sublime-theme文件名，例如"Material-Theme-Darker.sublime-theme"，不能漏后缀、不能写成material-theme-darker（小写）或Material Theme Darker（空格分隔） -
color_scheme的值必须以Packages/开头，例如"Packages/Material Theme/schemes/Material-Theme-Darker.tmTheme"，漏掉Packages/就直接回退黑底或 Monokai - macOS/Linux 用户注意：文件系统区分大小写，
Ayu和ayu是两个不同目录；Windows 虽不区分，但 Sublime 内部路径匹配仍严格按大小写处理
改完设置必须完全重启，不是重开窗口
ST4 缓存极强，仅关闭再打开单个窗口不会刷新 UI 主题。很多“重启了还是没变”的问题，其实只是没真正退出进程。
- Windows/macOS：右键任务栏/程序坞图标 → 选择「退出」或「Quit Sublime Text」，确认所有 Sublime 进程已终止
- Linux：终端执行
pkill -f "subl"或手动杀掉sublime_text进程 - 验证是否清缓存：重启后首次打开时，状态栏应短暂显示「Loading theme...」，否则说明旧缓存仍在生效
别手动填路径，用命令面板选一次再复制
自己拼路径容易错，最稳妥的方式是让 Sublime 先加载成功，再抄它实际用的路径。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入UI: Select Theme回车，选一个带 ✔️ 的项（说明已识别） - 再输
UI: Select Color Scheme，选对应变体，此时状态栏会实时显示完整路径，例如Packages/ayu/schemes/ayu-mirage.tmTheme - 打开
Preferences → Settings – User，把这两行粘贴进去，确保和已有 JSON 格式对齐（逗号、引号、缩进）
图标不显示？90% 是没开 file_icons
装了 A File Icon 或 Seti_UI 却只看到空白方块，基本就是这个布尔开关没设。
- 在
Settings – User中加一行："file_icons": true（注意是布尔值，不是字符串） - 确认没装冲突插件：比如旧版
FileIcons会覆盖新逻辑，卸载它 - 右键侧边栏 → 检查「Enable File Icons」是否勾选（部分 ST4 版本需手动触发一次）
- 该字段必须和
theme同级，写在对象顶层，拼错名字（如file_icon或enable_file_icons）无效
真正卡住人的地方，往往不是主题本身，而是 theme 和 color_scheme 这两个字段像一对锁——缺一不可，钥匙齿形还必须严丝合缝。哪怕你只多打了一个空格，Sublime 也只会沉默地给你一个默认界面，连个提示都没有。
