Sublime Text的语法定义文件是基于YAML的配置文件，用于定义代码高亮规则。它通过name、file_extensions、scope和contexts等字段，指定语言名称、关联扩展名、作用域及匹配规则，利用正则表达式识别关键字、注释、字符串等元素，并结合主题文件实现着色。用户可创建.sublime-syntax文件，定义上下文与作用域，测试后实现自定义语言高亮。
Sublime Text 的语法定义文件是用来定义代码高亮规则的配置文件，通常以 .sublime-syntax 为扩展名。这类文件基于 YAML 格式编写，用于告诉 Sublime Text 如何识别某种编程语言的关键字、注释、字符串、函数等元素，并为其应用相应的颜色和样式。
一、什么是 .sublime-syntax 文件？
.sublime-syntax 是 Sublime Text 3 及以上版本使用的现代语法定义格式，取代了旧版的 .tmLanguage（基于 XML）。它结构清晰、易于编写和维护，支持正则表达式匹配和上下文切换，适合定义各种语言的高亮规则。
一个典型的语法文件包含以下内容：
- name：语法显示名称（如 "MyLang"）
- file_extensions：关联的文件扩展名（如 mylang, ml）
- scope：作用域名称（如 source.mylang）
- contexts：定义匹配规则的上下文，如主上下文、注释、字符串等
二、如何创建自定义语言高亮？
下面是一个简单的步骤，教你从零开始为一种自定义语言添加语法高亮。
1. 打开语法包目录
在 Sublime Text 中：
- 菜单栏选择 Preferences → Browse Packages…
- 进入后新建一个文件夹，比如命名为 MyCustomLang
2. 创建 .sublime-syntax 文件
在该文件夹中新建文件：MyLang.sublime-syntax
3. 编写基础语法定义
示例：为一种叫 MyLang 的简单语言定义高亮
% YAML 1.2 --- name: MyLang file_extensions: [mylang] scope: source.mylang <p>contexts: main:</p><ul><li><p>match: '#.*$' scope: comment.line.number-sign</p></li><li><p>match: '\b(if|else|while|func)\b' scope: keyword.control.mylang</p></li><li><p>match: '"[^"]*"' scope: string.quoted.double.mylang</p></li><li><p>match: '\b(true|false|null)\b' scope: constant.language.mylang</p></li><li><p>match: '\b\d+\b' scope: constant.numeric.mylang
4. 解释关键字段
- match：使用正则表达式匹配文本
- scope：指定匹配内容的作用域，决定颜色主题如何着色
-
contexts：可以定义多个上下文，比如
main是入口点，还可定义string_context等嵌套状态
三、作用域（Scope）与主题配合
语法文件只负责“标记”文本属于什么类型，真正决定颜色的是当前使用的 Color Scheme（主题文件，通常是 .tmTheme 或 .sublime-color-scheme）。
例如，如果你设置了 keyword.control.mylang，主题中需要有对应的作用域样式才能看到高亮效果。大多数主题已预定义常见作用域（如 keyword、string、comment），因此一般无需额外设置。
四、测试与调试
- 保存文件后，打开一个
.mylang后缀的文件，查看是否自动应用语法 - 可通过菜单 View → Syntax → MyLang 手动切换
- 使用 Tools → Developer → Show Scope Name 查看光标处的作用域，确认匹配是否正确
五、进阶功能
- 嵌套上下文：可用于处理多行字符串或嵌套注释
- push / pop / clear：控制上下文栈，实现复杂状态切换
- with_prototype：在进入某个上下文前先加载一组规则
例如，进入多行字符串：
- match: '«'
push: triple-string-context
set:
- match: '»'
pop: true
- match: '\n'
scope: invalid.illegal.newline
六、参考资源
- 官方文档：https://www.php.cn/link/d645da12228499ac88ef5cced5837502
- 查看现有语法文件：在 Packages 目录下找 JavaScript.sublime-syntax、Python.sublime-syntax 学习写法
- 使用 PackageDev 插件辅助开发（支持语法高亮、校验、模板生成）
基本上就这些。写一个基础的语法文件不难，关键是理解上下文和作用域机制。只要会正则，就能快速上手自定义语言高亮。
