Sublime Text切换UI主题需同时正确配置theme字段和确保主题文件被识别。theme值必须为精确的.sublime-theme文件名（含大小写、连字符、后缀），置于Packages/目录下，且须重启软件生效；若UI: Select Theme列表中无该主题，则配置无效。
theme 和 color_scheme 是两个独立配置项，换主题不等于换配色，必须分别处理。直接改 Settings – User 里的 "theme" 字段就能生效，但路径、后缀、大小写错一个，Sublime 就静默忽略——它不会报错，也不会提示你哪里不对。
确认已安装的 UI 主题文件名
Sublime 不认“名字”，只认 .sublime-theme 文件的完整路径名。比如装了 Material Theme，实际生效的是 "Material-Theme.sublime-theme"，不是 "Material Theme" 或 "MaterialTheme"。
- 打开
Preferences → Browse Packages，进入Packages/目录 - 找到对应主题文件夹（如
Material Theme/），再进themes/或根目录找以.sublime-theme结尾的文件 - 右键 → 属性（Windows）或
ls -la（macOS/Linux）确认真实文件名，含连字符、空格、大小写、后缀一个都不能少
在 Settings – User 中正确配置 theme
必须编辑 Preferences → Settings – User（不是 Default），且值必须是字符串，带双引号，路径中不能有中文或非法字符。
-
"theme": "Material-Theme.sublime-theme"✅ -
"theme": "Material Theme"❌（缺后缀，Sublime 当作无效值丢弃） -
"theme": "Packages/Material Theme/Material-Theme.sublime-theme"❌（theme字段不支持Packages/前缀，只接受裸文件名） - 如果主题依赖额外资源（如图标、高亮补丁），需同步配置
"icon_theme"或启用配套插件
重启 Sublime Text 才能确保 UI 主题完全加载
很多 UI 主题（尤其是 Material、Origami 等）会在首次加载时生成缓存、注入 CSS、重绘侧边栏结构。仅靠热重载或修改设置无法触发完整初始化。
- 关闭所有 Sublime 窗口（包括后台进程），再重新打开
- 观察状态栏右下角是否显示新主题名；若仍为旧样式，检查是否被其他插件（如 Theme Toggler）覆盖了设置
- 若侧边栏错位、标签页消失、滚动条异常，大概率是主题与当前 Sublime 版本不兼容（如 Sublime Text 4 的主题在 ST3 上运行）
常见失败原因：路径对了，但主题没变
最隐蔽的问题不是配置错，而是主题文件本身没被识别——Sublime 只加载位于 Packages/ 下的 .sublime-theme，不加载 Installed Packages/xxx.sublime-package 内压缩包里的同名文件（除非该 package 已解压并手动放入 Packages/）。
- 用
Ctrl+Shift+P输入UI: Select Theme，看列表里有没有你的主题名；没有就说明 Sublime 根本没扫描到 - 检查主题是否被放在
Installed Packages/而非Packages/——前者是只读压缩包，后者才是可读写目录 - 某些主题（如 Soda）要求额外下载
.tmTheme配色包并手动解压到Packages/，否则 UI 元素颜色会异常灰暗
主题切换真正卡住的地方，往往不在“怎么配”，而在“Sublime 到底看见了没”。别急着调参数，先用 UI: Select Theme 看列表，列表里没有，一切配置都是白搭。
