首先定义语言标识与文件扩展名，再通过language-configuration.json配置注释、括号等基础行为，接着使用TextMate语法规则（.tmLanguage.json）定义关键字、字符串、注释等元素的匹配模式与作用域名称，最后在VSCode中注册文法并测试高亮效果，确保正则准确且作用域命名规范以适配主流主题。
要实现 VSCode 中的语法高亮扩展，核心是通过定义语言的文法（Grammar）来告诉编辑器如何识别和着色代码中的不同元素。语法高亮本身并不依赖语言服务器，而是基于 TextMate 语法规则或 Semantic Token（语义标记）来实现。
1. 定义语言支持
在编写语法高亮扩展前，需先声明你的语言。创建 package.json 文件并在 contributes.languages 中注册语言基本信息：
- id：语言唯一标识符（如 mylang）
- extensions：该语言文件的后缀名（如 .myl）
- aliases：语言的显示名称
示例：
{
"contributes": {
"languages": [
{
"id": "mylang",
"extensions": [".myl"],
"aliases": ["MyLang", "mylang"],
"configuration": "./language-configuration.json"
}
]
}
}
2. 配置语言基本行为
创建 language-configuration.json 文件，定义括号匹配、注释格式、自动补全等基础行为：
{
"comments": {
"lineComment": "//",
"blockComment": ["/*", "*/"]
},
"brackets": [
["{", "}"],
["[", "]"],
["(", ")"]
],
"autoClosingPairs": [
["{", "}"],
["[", "]"],
["(", ")"],
[""", """],
["'", "'"]
]
}
3. 实现语法高亮（TextMate 规则）
语法高亮的核心是使用 TextMate 语法规则（.tmLanguage.json 文件）。VSCode 支持 JSON 格式的文法定义。
在 package.json 中注册：
jm-jsjkxyjs02-zlm-405
下载
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
{
"contributes": {
"grammars": [
{
"language": "mylang",
"scopeName": "source.mylang",
"path": "./syntaxes/mylang.tmLanguage.json"
}
]
}
}
mylang.tmLanguage.json 示例：
{
"scopeName": "source.mylang",
"patterns": [
{
"name": "keyword.control.mylang",
"match": "\b(if|else|while)\b"
},
{
"name": "string.quoted.double.mylang",
"begin": """,
"end": """,
"patterns": [
{
"name": "constant.character.escape.mylang",
"match": "\\."
}
]
},
{
"name": "comment.line.double-slash.mylang",
"match": "//.*$"
}
],
"repository": {},
"uuid": "..."
}
关键字段说明：
- scopeName：必须与 grammar 注册时一致
- match：正则表达式匹配文本
- name：作用域名称，决定颜色（由主题映射）
- begin/end：用于多行结构（如字符串、注释）
4. 测试与调试
使用 VSCode 的扩展开发环境（F5 启动）测试高亮效果。可借助以下工具：
- Developer: Inspect Editor Tokens and Scopes 命令查看当前光标位置的 token 和作用域
- 检查正则是否正确捕获目标语法
- 确认 .tmLanguage.json 被正确加载
确保语法作用域命名符合社区惯例，以便兼容主流主题的颜色配置。
基本上就这些。语法高亮扩展不涉及复杂逻辑，关键是写对正则和作用域命名。只要文法定义清晰，VSCode 就能自动完成着色。发布前建议在多种主题下测试显示效果。
