Sublime语法高亮失效主因是scope未正确配置、match被前置规则捕获或文件未加载；需确保语法文件路径合法、命名规范、YAML格式正确、file_extensions手动注册并重载定义。
Sublime 的语法高亮不生效，90% 是因为 scope 没挂对、match 被吞掉，或者文件根本没被加载——不是正则写得不够 fancy，而是基础链路断了。
语法文件路径和命名必须严格合法
Sublime 会静默忽略所有不合规的 .sublime-syntax 文件，连错误提示都不给。
- 文件必须放在
Packages/User/或Packages/YourPluginName/下，不能嵌套在子文件夹里（比如Packages/User/mylang/rules/就无效） - 文件名只能含英文、数字、下划线、短横线，且必须以
.sublime-syntax结尾：mylang.sublime-syntax✅，MyLang.syntax❌，mylang sub.sublime-syntax❌ - Windows/macOS/Linux 的 Packages 路径不同，但统一从
Packages/开始；用Preferences → Browse Packages…打开最稳 - YAML 缩进必须用空格，不能用 Tab；冒号后必须跟一个空格，比如
file_extensions: [ "myl" ]，写成file_extensions:["myl"]或file_extensions: "myl"都会失效
scope 和 match 必须成对出现，且顺序决定匹配结果
scope 不是“作用域”概念，而是告诉 Sublime：“这段文本语义上属于什么”，没有它，match 再准也白搭。
-
match: '\b(if|else)\b'单独存在 = 匹配成功但不着色；必须加scope: keyword.control.mylang - 规则按书写顺序执行：如果字符串引号规则写在关键字前面，
"if"整个被当字符串捕获，if就永远进不了关键字规则 - 作用域名要带层级，推荐用
keyword.control.mylang而非keyword，避免和主题里其他语言冲突；但前提是主题真支持这个 scope，否则回落成默认灰 - 用
Ctrl+Shift+P → Inspect Scope把光标停在目标词上，看弹出的 scope 链是不是你写的，比如keyword.control.mylang—— 不是？说明没匹配上，或被更早规则截胡
file_extensions 不只是“写上就行”，还要手动注册一次才永久生效
改完 file_extensions 字段后，Sublime 不会自动重读所有扩展名映射，尤其对冷门后缀（如 .xyz、.conf）。
- 先打开一个
test.xyz文件，右下角点Plain Text→ 选你的语法（如User → MyLanguage） - 再点菜单
View → Syntax → Open all with current extension as… → User → MyLanguage - 这个操作只改当前会话；真正永久生效要等 Sublime 重载语法定义：重启编辑器，或运行
Ctrl+Shift+P → Reload Syntax Definitions - 验证方式：新建一个
xxx.xyz，看右下角是否直接显示MyLanguage；如果还是Plain Text，说明注册失败
调试时最容易被忽略的三个底层问题
很多“明明写了却没反应”的问题，卡在看不见的地方。
- 编码必须是 UTF-8 无 BOM，否则 YAML 解析失败（尤其是 Windows 记事本保存的文件）
- Sublime 有缓存机制，改完语法文件后不重启 / 不重载，可能还在用旧版本；
Reload Syntax Definitions比重启更快，但某些情况仍需重启 - 作用域层级太深或太偏门（比如
support.class.react.mylang），当前 color_scheme 根本没定义对应 rule，结果就是匹配上了也不变色——此时得去改.sublime-color-scheme，而不是怪语法文件
