Sublime Text的颜色方案文件必须放在Packages/User/目录下，macOS和Windows均可通过Preferences → Browse Packages…快速打开；新版强制使用.sublime-color-scheme（JSON5格式），需在用户设置中显式指定color_scheme路径并重启编辑器生效。
颜色方案文件路径在哪？别乱放
Sublime Text 的颜色方案（.sublime-color-scheme）必须放在 Packages/User/ 目录下才能被识别，不是随便丢进某个 Resources 或 Data 文件夹就行。macOS 和 Windows 路径不同，但都能通过菜单快速打开：Preferences → Browse Packages…，进去后直接进 User 文件夹。
- 旧版 Sublime Text（如 3.x）可能还在用
.tmTheme（XML 格式），新版（4.x+）强制要求 .sublime-color-scheme（JSON5 格式），两者不兼容
- 如果你从网上下载的是
.tmTheme，不能直接改后缀名了事——结构完全不同，会报错 Unable to parse color scheme
- 不建议覆盖默认方案（比如
Monokai.sublime-color-scheme），改名另存为新文件更安全，比如 Monokai-2026.sublime-color-scheme
怎么让新方案出现在主题菜单里？
Sublime Text 不会自动扫描 User/ 下所有 .sublime-color-scheme 文件并注册到菜单。必须在设置中显式指定：
- 打开
Preferences → Settings（右侧用户设置），添加或修改 "color_scheme" 字段：
"color_scheme": "Packages/User/Monokai-2026.sublime-color-scheme"
- 路径必须以
Packages/ 开头，不能写相对路径或绝对路径
- 文件名大小写敏感，Windows 上容易忽略这点，比如写成
monokai-2026.sublime-color-scheme 就加载失败
更新后没生效？检查这三件事
常见“改了但没变”的原因往往和缓存、语法绑定、或 JSON 格式错误有关：
- Sublime Text 4 启动时会缓存 color scheme 解析结果，改完文件后必须重启编辑器（仅
Ctrl+Shift+P → Reload Color Scheme 不一定刷新全部状态）
- 某些插件（如 BracketHighlighter、Indent Guides）会自己读取 color scheme 配置，它们的高亮规则可能仍沿用旧值，需单独重载插件或重启
- JSON5 允许注释和末尾逗号，但缩进错误、漏掉引号、布尔值写成
true 而非 true（其实这个对）——真正易错的是 "foreground": null 写成 "foreground": "null"，后者会被当字符串解析，导致文字消失
想兼容 ST3 和 ST4？别强求
ST3 的 .tmTheme 和 ST4 的 .sublime-color-scheme 是两套渲染逻辑，没有官方转换工具。强行用脚本转，大概率丢失 scope 映射精度（比如 support.function.builtin.python 在新版里可能已拆成多个 scope）。
- 如果团队混用 ST3/ST4，建议统一升级到 ST4（免费，且 ST3 已停止维护）
- 第三方方案作者（如 Ayu、Dracula）通常只维护 ST4 版本，ST3 分支早已冻结，继续用会有 scope 匹配不准、暗色模式异常等问题
- 真要临时过渡，可用
Package Control → Install Package → Theme - Default 回退到内置方案保底，而不是硬扛过时格式
.tmTheme（XML 格式），新版（4.x+）强制要求 .sublime-color-scheme（JSON5 格式），两者不兼容.tmTheme，不能直接改后缀名了事——结构完全不同，会报错 Unable to parse color scheme
Monokai.sublime-color-scheme），改名另存为新文件更安全，比如 Monokai-2026.sublime-color-scheme
User/ 下所有 .sublime-color-scheme 文件并注册到菜单。必须在设置中显式指定：
- 打开
Preferences → Settings（右侧用户设置），添加或修改"color_scheme"字段："color_scheme": "Packages/User/Monokai-2026.sublime-color-scheme"
- 路径必须以
Packages/开头，不能写相对路径或绝对路径 - 文件名大小写敏感，Windows 上容易忽略这点，比如写成
monokai-2026.sublime-color-scheme就加载失败
更新后没生效？检查这三件事
常见“改了但没变”的原因往往和缓存、语法绑定、或 JSON 格式错误有关：
- Sublime Text 4 启动时会缓存 color scheme 解析结果，改完文件后必须重启编辑器（仅
Ctrl+Shift+P → Reload Color Scheme 不一定刷新全部状态）
- 某些插件（如 BracketHighlighter、Indent Guides）会自己读取 color scheme 配置，它们的高亮规则可能仍沿用旧值，需单独重载插件或重启
- JSON5 允许注释和末尾逗号，但缩进错误、漏掉引号、布尔值写成
true 而非 true（其实这个对）——真正易错的是 "foreground": null 写成 "foreground": "null"，后者会被当字符串解析，导致文字消失
想兼容 ST3 和 ST4？别强求
ST3 的 .tmTheme 和 ST4 的 .sublime-color-scheme 是两套渲染逻辑，没有官方转换工具。强行用脚本转，大概率丢失 scope 映射精度（比如 support.function.builtin.python 在新版里可能已拆成多个 scope）。
- 如果团队混用 ST3/ST4，建议统一升级到 ST4（免费，且 ST3 已停止维护）
- 第三方方案作者（如 Ayu、Dracula）通常只维护 ST4 版本，ST3 分支早已冻结，继续用会有 scope 匹配不准、暗色模式异常等问题
- 真要临时过渡，可用
Package Control → Install Package → Theme - Default 回退到内置方案保底，而不是硬扛过时格式
Ctrl+Shift+P → Reload Color Scheme 不一定刷新全部状态）true 而非 true（其实这个对）——真正易错的是 "foreground": null 写成 "foreground": "null"，后者会被当字符串解析，导致文字消失.tmTheme 和 ST4 的 .sublime-color-scheme 是两套渲染逻辑，没有官方转换工具。强行用脚本转，大概率丢失 scope 映射精度（比如 support.function.builtin.python 在新版里可能已拆成多个 scope）。
- 如果团队混用 ST3/ST4，建议统一升级到 ST4（免费，且 ST3 已停止维护）
- 第三方方案作者（如 Ayu、Dracula）通常只维护 ST4 版本，ST3 分支早已冻结，继续用会有 scope 匹配不准、暗色模式异常等问题
- 真要临时过渡，可用
Package Control → Install Package → Theme - Default回退到内置方案保底，而不是硬扛过时格式
颜色方案不是改完保存就完事，它依赖路径、格式、加载时机三者同时正确；最容易被跳过的其实是重启编辑器——很多人反复 reload 却没意识到 ST4 的 parser 缓存机制比以前更顽固。
