Sublime加载颜色方案失败时静默回退至默认主题，主因是color_scheme路径错误、格式不兼容（ST4仅支持.sublime-color-scheme）、User设置覆盖或scope不匹配；需验证路径、格式、配置层级及语法高亮scope。
颜色方案文件路径不对，Sublime 就会静默失败
Sublime 不会报错提示“找不到 color_scheme”，而是直接回退到默认配色（通常是 Monokai），看起来像主题生效了，其实根本没加载你指定的方案。关键看 Preferences.sublime-settings 里 color_scheme 的值是否指向一个真实存在的 .sublime-color-scheme 文件（Sublime Text 4）或 .tmTheme（ST3 及更早）。路径必须是相对于 Packages/ 的相对路径，或者用 Packages/ 开头的绝对路径。
常见错误包括：
- 把文件放在
Packages/User/下，却写成MyScheme.sublime-color-scheme（缺Packages/User/前缀） - 用了系统绝对路径（如
/Users/xxx/Downloads/xxx.sublime-color-scheme），Sublime 不支持 - 文件名大小写不一致（macOS/Linux 区分大小写，
ayu-dark.sublime-color-scheme≠Ayu-Dark.sublime-color-scheme） - 复制了 .json 或 .xml 源文件，但没重命名为合法的
.sublime-color-scheme后缀
Sublime Text 4 必须用 JSON 格式 color scheme，旧版 tmTheme 不兼容
ST4 彻底弃用了 XML 格式的 .tmTheme，只认新的 JSON 结构 .sublime-color-scheme。如果你从 ST3 迁移、或下载了老主题，直接丢进 Packages/ 会加载失败——连日志都不报。
验证方式：打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入 Inspect Color Scheme，如果弹出 “No color scheme loaded” 或显示的是默认路径（如 Packages/Color Scheme - Default/Monokai.sublime-color-scheme），说明当前没加载成功。
转换建议：
- 优先找主题作者发布的 ST4 兼容版（通常 GitHub README 会注明）
- 用在线工具如 tmTheme Editor 导出为
.sublime-color-scheme - 手动改写需严格遵循官方 schema：
base_type、variables、rules三层结构，漏掉base_type会导致整个文件被忽略
Package Control 安装的主题可能未启用，或被 User 设置覆盖
通过 Package Control 安装的主题（如 Dracula Color Scheme）不会自动激活；它只是把文件放进 Packages/Dracula Color Scheme/，你仍需手动设置 color_scheme 路径。
更隐蔽的问题是：用户级配置（Packages/User/Preferences.sublime-settings）里的 color_scheme 会覆盖全局设置。哪怕你用菜单选了新主题，只要 User/Preferences.sublime-settings 里硬编码了另一条路径，就会以它为准。
排查步骤：
- 打开
Preferences → Settings – User，检查是否存在"color_scheme"字段 - 临时注释掉该行，保存，看是否恢复为预期主题
- 确认路径正确后，再取消注释——不要留空值或写成
null，Sublime 会当作无效而跳过
颜色方案依赖的 scope 名称不存在，高亮就“消失”
即使 color_scheme 加载成功，你也可能发现某些语法（比如 TypeScript 的 interface、Vue 的 <template>）没变色。这不是主题问题，而是当前语言包没给对应 token 打上标准 scope，导致主题规则无法匹配。
验证方法：将光标停在目标代码上，按 Ctrl+Shift+P → 输入 Developer: Show Scope Name，看输出的 scope 链（如 source.ts entity.name.type.interface.ts）。如果主题的 rules 里没覆盖这个 scope，就不会着色。
解决方向：
- 更新对应语言包（如
JavaScriptNext - ES6 Syntax或Vue Syntax Highlight） - 在主题的
rules中手动追加 scope 条目（注意顺序：靠后的 rule 会覆盖前面同 scope 的） - 避免滥用通配符
source或text，它们容易被其他 rule 误覆盖
真正卡住人的，往往不是路径写错，而是以为“文件放对了=主题生效了”，结果 scope 匹配不上，连调试入口都找不到。
