Sublime Text 4 仅支持 .sublime-color-scheme 格式,.tmTheme 已彻底弃用;需确保 color_scheme 路径大小写、扩展名、斜杠方向完全匹配,通过“Copy Path”和“Show Scope Name”验证有效性,并优先使用 Preferences: Customize Color Scheme 增量修改。

Sublime Text 4 只认 .sublime-color-scheme 格式,.tmTheme 已被彻底弃用;直接改用户设置里的 "color_scheme" 路径是最简生效方式,但路径大小写、扩展名、斜杠方向必须完全匹配,否则静默失效。
怎么确认当前配色方案格式是否有效
右键点击编辑区右下角显示的配色名称 → “Copy Path”,粘贴出来看:
- 必须是 Packages/xxx/xxx.sublime-color-scheme(不能是 .tmTheme)
- 路径中大小写必须一致,比如 Dracula Color Scheme 写成 dracula color scheme 就加载失败
- 若粘贴结果为空或路径不合法,说明 Sublime 根本没识别该文件——此时即使文件存在也不会生效
- 运行 Developer: Show Scope Name 命令,若弹出 scope 信息,说明配色已绑定;若空白,大概率是路径或格式问题
用 Preferences: Customize Color Scheme 安全增量修改
这是官方唯一支持热重载、不被升级覆盖、且容错性最高的方式:
- 按 Ctrl+Shift+P 输入 Preferences: Customize Color Scheme 回车
- 自动在 Packages/User/ 下生成 Custom.sublime-color-scheme
- 文件结构是 JSON patch 形式,只填你想改的部分,例如:
{
"globals": {
"background": "#2d2d2d",
"foreground": "#f8f8f2"
},
"rules": [
{ "scope": "selection", "background": "#44475a" },
{ "scope": "comment", "foreground": "#6272a4", "fontStyle": "italic" }
]
}
- 不要手写 variables 或完整 rules 框架,只补字段;多一个逗号、中文引号、漏大括号都会导致整个配色静默回退到 Monokai
- 改完保存,无需重启,但必须在 Preferences → Color Scheme 中重新选一次你的主题才刷新
为什么改了 background,string / comment 还是旧颜色
background 是全局底色,而语法元素(如字符串、注释)由 rules 数组里带 "scope" 的规则控制,二者完全解耦:
- "scope": "string" 和 "scope": "comment" 必须写对,推荐用 Developer: Show Scope Name 查光标处真实 scope(例如 source.python string.quoted.double.python)
- scope 匹配是“最精确优先”:写 string.quoted.double 比只写 string 更准,太宽泛容易被后续更具体的 rule 覆盖
- rule 在数组中的顺序很重要:靠前的 rule 先匹配,后面同 scope 的会被忽略
- 如果你用的是第三方主题(如 One Dark),它可能自带大量 rules,直接覆盖你的修改——这时要么删掉原主题的对应 rule(不推荐),要么确保你的 Custom.sublime-color-scheme 规则位置靠前、scope 更细
别碰 .tmTheme,也别手动写 XML
所有基于 .tmTheme 的教程都已过时:Sublime Text 4 不加载该格式,哪怕文件存在、路径正确、XML 结构无误,也只会静默跳过。
- PackageDev 插件生成的 .tmTheme 模板、Color Scheme Editor 旧版导出的 .tmTheme,都不能用于 ST4
- 手写 XML 容易漏闭合标签、错用 ,且无法热重载,调试成本高
- 真正该关注的是 scope 名称的准确性、JSON 语法的严格性、以及 Custom.sublime-color-scheme 的增量式写法——它不替代原主题,只打补丁,这才是 ST4 的设计意图











