必须用tools → developer → new syntax创建模板再修改，手写易因缩进、main缺失或contexts拼写错误导致静默失效；文件须存于packages/user/下且名以.sublime-syntax结尾；match规则顺序决定高亮成败，调试需用show scope name验证作用域命中。
语法文件必须用 Tools → Developer → New Syntax 创建
手写 .sublime-syntax 容易出错：缩进错一级、漏掉 main 上下文、contexts 写成 context，都会导致静默失效。Sublime 自带的模板已预置合法 YAML 结构和必需字段（name、scope、file_extensions、contexts），直接改比从零敲安全得多。
打开后先改三处：
-
name：状态栏显示名，比如MyConfig -
scope：必须以source.开头，如source.myconfig；别写myconfig或text.myconfig -
file_extensions：用 YAML 列表格式，如- cfg、- env，不是"cfg"或["cfg"]
保存路径和文件名有硬性要求
Sublime 只扫描 Packages/User/ 目录及其子目录下的 .sublime-syntax 文件，其他位置一概无视。
Windows 路径示例：%APPDATA%\Sublime Text\Packages\User\myconfig\myconfig.sublime-syntax
macOS/Linux 路径示例：~/Library/Application Support/Sublime Text/Packages/User/myconfig/myconfig.sublime-syntax
关键限制：
- 文件名必须以
.sublime-syntax结尾，myconfig.syntax或myconfig.sublime-syntax.bak都无效 - 大小写敏感：
MyConfig.sublime-syntax和myconfig.sublime-syntax是两个不同文件 - 不能嵌套太深：放在
Packages/User/myconfig/下可以，但Packages/User/myconfig/v1/就不会被识别
match 规则顺序决定高亮成败
正则没生效？90% 是规则顺序错了。Sublime 按 contexts 里从上到下的顺序匹配，一旦某条 match 吃掉了文本，后续规则就再没机会。
典型陷阱：
- 字符串规则写在关键字前面 →
"if"整个被当字符串捕获，if关键字永远不触发 - 注释规则写在行首锚定（
^#）但没加$或换行符处理 → 匹配失败，整行回落为默认颜色 - 用了
push:进入新 context 却没配pop: true→ 后续所有文本卡在该 context，全变同一种颜色
调试时按 Ctrl+Shift+P 输入 Show Scope Name，把光标停在目标词上，看弹出的作用域是不是你写的 keyword.control.myconfig —— 不是？说明根本没匹配上。
高亮颜色不出现，问题大概率不在语法文件
语法文件只负责“打标签”，颜色由当前 color_scheme 决定。如果你用了 scope: keyword.control.myconfig，但主题里没定义这个作用域，结果就是纯白。
最省事的做法：复用主流 scope 名，比如 keyword.control、string.quoted.double、comment.line.number-sign —— 这些几乎所有主题都支持。
如果非要加后缀（如 keyword.control.myconfig），就得手动改 .tmTheme 文件，在 settings 数组里加一条：
<dict><key>scope</key><string>keyword.control.myconfig</string><key>settings</key><dict><key>foreground</key><string>#f92672</string></dict></dict>
别指望改完立刻生效：Sublime 不自动重载 theme，得重启或手动执行 Preferences → Color Scheme 再选一次。
真正容易被忽略的是 file_extensions 绑定后缀后，仍需手动触发一次“Open all with current extension as…”——否则新语法不会自动应用到已有文件，哪怕后缀完全匹配。
