Sublime识别新后缀需先临时绑定语法，再通过Preferences→Settings–Syntax Specific添加{"extensions":["foo"]}持久配置；自定义语法须存于Packages/User/，文件名小写无空格，正则反斜杠双写，scope用source.xxx格式。
怎么让 Sublime 识别新文件后缀（比如 .foo）
Sublime 默认不认你随便起的后缀，得手动绑定到已有语法或自定义语法。最直接的办法是：右键编辑器标签页 → “Set Syntax” → “Open all with current extension as…”，选一个接近的语法（比如 Plain Text 或 Python）。这会立刻生效，但只是临时映射，重启后可能丢失。
真正持久的写法是加一条用户配置：菜单 Preferences → Settings – Syntax Specific，然后填入：
{
"extensions": ["foo"]
}注意：extensions 是数组，不是字符串；路径里不能有空格或特殊字符；如果文件已打开，需关闭再重开才触发识别。
如何写一个最简可用的 .sublime-syntax 文件
不用从零写复杂正则，先复用已有语法改扩展名和名字就行。新建文件，保存为 Packages/User/MyLang.sublime-syntax（Packages/User/ 是安全目录，不会被升级覆盖），内容如下：
%
version: 2
name: MyLang
file_extensions:
- myl
scope: source.myl
contexts:
main:
- match: '\b(print|return)\b'
scope: keyword.control
- match: '"([^"]*)"'
scope: string.quoted.double
关键点：
-
name和file_extensions必须小写，且不含空格 -
scope建议用source.xxx格式，方便后续配主题或插件 - 正则里反斜杠要双写（
\b），否则解析失败，错误不报，只静默失效 - 保存后，用
Ctrl+Shift+P→Set Syntax: MyLang手动切换测试
invalid regex 错误怎么快速定位
这是写 .sublime-syntax 时最高频的卡点——Sublime 不提示哪行错，只在控制台（Ctrl+`）输出 invalid regex，然后整个语法加载失败。
排查顺序：
- 检查所有
match和push下的正则，是否用了?、+、*等量词但没转义字面量（比如想匹配foo?，得写成foo\?） - 确认没用 PCRE 特有语法（如
(?i)、\K），Sublime 只支持 RE2 子集 - 把正则拆成单行，逐个注释掉再试；或者复制到在线工具（如 regex101.com，选 RE2 模式）验证
- 注意
captures的 key 必须是数字字符串（"1"），不是整数（1），否则也报 invalid regex
为什么主题不染色、命令不生效
语法文件本身只是定义 token 类型（比如把 if 标为 keyword.control），真正染色靠 color scheme，命令响应靠 scope 匹配。常见断点：
- 主题里没定义
keyword.control对应颜色 → 检查当前 color scheme（Color Scheme – Default.sublime-package解压后找.tmTheme） - 想让
Ctrl+Click跳转函数，但没加meta.functionscope → 单纯高亮不够，必须嵌套进语义 scope 才能被插件识别 - 用了
embed引入其他语法（比如在 HTML 里嵌 JS），但没声明embed_scope→ 外层语法无法透传 scope，导致子语言失效 - 语法文件放错位置（比如丢进了
Packages/SomePlugin/）→ Sublime 只扫描Packages/User/和各插件根目录下的.sublime-syntax
Scope 层级深了容易漏掉某一级，调试时打开命令面板运行 Tools → Developer → Show Scope Name，光标停在哪就看哪的完整 scope 链，比猜靠谱得多。
