Sublime Text 自定义代码高亮本质是修改 color_scheme 配色方案,需先用 Developer: Show Scope Name 查准目标词的 scope(如 storage.type.js),再在 Packages/User/xxx.sublime-color-scheme 的 "rules" 中精确匹配该 scope 添加颜色规则,最后手动重选配色方案生效。

Sublime Text 自定义代码高亮主题,本质是改 color_scheme(配色方案),不是换 UI 主题,也不是直接改语法文件——这两者完全独立,混着动就白调。
怎么确认当前关键字的准确 scope 名称
想让某个词变色,第一步不是打开配置文件,而是查它现在被 Sublime 认成什么 scope。光标停在目标词上(比如 async、TODO 或你自定义语法里的 myfunc),按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入并执行 Developer: Show Scope Name。
- 状态栏会显示一串 scope,如
source.js meta.function.js storage.type.js,真正起作用的是最右边那个——storage.type.js - 如果只看到
source.mylang,说明你的自定义语法没命中内容,得回头检查match正则或file_extensions拼写 - scope 区分大小写:
keyword.control.mylang和keyword.control.MYLANG是两个不同 scope - 别写
keyword.*.mylang—— color scheme 不支持通配符匹配
怎么在 .sublime-color-scheme 里加颜色规则
Sublime 当前主推 JSON 格式的 .sublime-color-scheme(替代旧版 XML 的 .tmTheme)。必须放在 Packages/User/ 目录下,并在用户设置中显式指定路径:
- 用命令面板运行
New Color Scheme(需安装 PackageDev 插件),生成标准模板,避免结构错误 - 在
"rules"数组里添加对象,例如:{ "name": "MyLang keyword", "scope": "keyword.control.mylang", "foreground": "#FF6B6B" } -
scope字段必须和Show Scope Name显示的末尾值**完全一致** - 多个 scope 可合并写:
"scope": "keyword.control.mylang constant.numeric.mylang" - 加了
background要小心:可能和lineHighlight或选中背景色冲突,导致文字看不清
为什么改了文件还是没变色
最常见的失效原因不是写错,而是加载链断在某个环节:
- 配色方案文件没放对位置:必须是
Packages/User/xxx.sublime-color-scheme,不能是Packages/Default/或其他路径 - 用户设置里漏了
"color_scheme"行,或路径写成小写packages/user/、用了反斜杠\ - 改完保存后,必须手动在
Preferences → Color Scheme里重新选一次——Sublime 不会自动切换到刚保存的文件 - 文件语法识别错了:右下角显示的是
Plain Text?先点它选对语言,否则 scope 根本不会生成
真正卡住的地方往往不在颜色值本身,而在 scope 是否被正确赋予、文件是否被正确加载、路径大小写是否严格匹配——这三个环节任意一个出错,前面所有颜色设置都等于没写。


















