Sublime需通过语法文件的file_extensions字段绑定后缀，而非Preferences设置；修改sublime-syntax文件时须用YAML格式列表、正确缩进和引号；scope与match必须配合使用，缺一不可；文件名路径需合法且无语法错误，否则静默失效。
怎么让 Sublime 识别一个新文件后缀并高亮
直接改 Preferences.sublime-settings 不起作用——那只是用户偏好，不定义语法。真正要做的，是把文件扩展名和某个语法定义绑定起来。
操作路径：菜单 View → Syntax → Open all with current extension as… → [选中你的语法]。这会立刻在当前窗口生效，但只是一次性；要永久生效，得改语法文件本身的 file_extensions 字段。
- 打开对应语法文件（通常在
Packages/User/xxx.sublime-syntax或Packages/xxx/xxx.sublime-syntax） - 确认里面有类似
file_extensions: [ "myext", "myconfig" ]的字段（注意是 YAML 格式，冒号后空一格） - 改完保存，重启 Sublime 或用
Ctrl+Shift+P→Reload Syntax Definitions
常见错误：写成 file_extensions: "myext"（字符串非列表）、漏掉引号、用了中文逗号。
sublime-syntax 文件里 scope 和 match 是什么关系
scope 不是“作用域”那种编程概念，而是告诉 Sublime：“这段文本应该被当成什么语义来着色”，比如 keyword.control 表示这是个控制关键字（if、for），string.quoted.double 表示双引号字符串。而 match 是正则表达式，负责“抓出”这些文本。
二者必须配合：没有 match，scope 就没地方挂；只有 match 没给 scope，Sublime 就当普通文本处理，不着色。
-
match: '\b(if|else|for|while)\b'+scope: keyword.control→ 正确高亮关键词 - 漏写
scope行，或写成scope: ''，结果就是匹配上了也不变色 - 正则里用了
(?i)忽略大小写，但scope写错（如keyword.control.python）也不会报错，只是不生效
为什么写好了 sublime-syntax 却没高亮，连语法列表里都找不到
最常见原因是文件名或路径不合法：.sublime-syntax 文件必须放在 Packages/ 下的某处，且文件名不能含空格、中文、特殊符号（比如 My Config.sublime-syntax 就会被忽略）。
另一个高频坑：YAML 语法错误。Sublime 对 YAML 解析很严格，缩进错一位、多一个空格、用了 Tab 而不是空格，整个语法文件就静默失效。
- 检查文件是否在
Packages/User/或Packages/YourPluginName/下（不能在子文件夹里） - 文件名只用英文、数字、下划线、短横线，例如
ini_highlight.sublime-syntax - 用
Ctrl+Shift+P→Developer: Show Scope Name看光标位置的实际 scope，反推语法是否加载成功 - 打开 Sublime 控制台（
Ctrl+`），看有没有error parsing syntax file类提示
想复用已有语法做微调，比如给 TOML 加个自定义字段高亮
别复制粘贴整个官方 TOML 语法文件——升级时会被覆盖，而且维护成本高。正确做法是用 include 引入原语法，再叠加自己的规则。
比如你在 Packages/User/toml-plus.sublime-syntax 里写：
% version: 2 name: TOML Plus file_extensions: - toml-plus scope: source.toml <p>contexts: main:</p><ul><li>include: Packages/TOML/TOML.sublime-syntax</li><li>match: '\b(custom_field)\b' scope: support.constant.toml-plus
这样既保留原 TOML 所有高亮，又额外加了一条规则。注意 include 路径必须准确，大小写敏感，且目标语法已安装（比如通过 Package Control 安装的 TOML 包）。
容易被忽略的是：如果原语法用了 embed 或 with_prototype，你的新增规则可能被嵌套上下文过滤掉——这时得把新规则放进对应 context 里，而不是只写在 main 下。
