VSCode语言支持:开发新型编程语言语法扩展包

首先创建语言扩展项目并定义基础配置,再通过TextMate语法规则实现语法高亮;接着在language-configuration.json中设置注释、括号匹配等编辑行为,然后在.tmLanguage.json中使用正则定义关键字、字符串等元素的着色规则;最后通过调试窗口测试高亮效果,并利用vsce工具发布到vscode Marketplace。

VSCode语言支持:开发新型编程语言语法扩展包

想在 VSCode 中为一种新型编程语言添加语法支持,核心是创建一个语法高亮扩展包。这个过程不复杂,重点在于定义语言的基本规则,并通过 TextMate 语法规则实现着色效果。

定义语言基础配置

新建一个 VSCode 扩展项目,使用 vscode yeoman generator 快速初始化:

yo code

选择“New Language Support”模板,填写语言名、文件扩展名(如 .mylang)、语言 ID 等信息。生成的结构包含以下关键文件:

  • language-configuration.json:定义括号匹配、注释格式、自动缩进等基本编辑行为
  • syntaxes/mylang.tmLanguage.json:TextMate 语法文件,控制关键字、变量、注释等的高亮样式

例如,在 language-configuration.json 中声明行注释符号和括号配对:

{   "comments": {     "lineComment": "//",     "blockComment": [ "/*", "*/" ]   },   "brackets": [     [ "{", "}" ],     [ "[", "]" ],     [ "(", ")" ]   ],   "autoClosingPairs": [     { "open": "{", "close": "}" },     { "open": "[", "close": "]" },     { "open": "(", "close": ")" },     { "open": """, "close": """, "notIn": ["string"] }   ] }

编写语法高亮规则

VSCode 使用 TextMate 的正则语法来定义着色规则。在 .tmLanguage.json 文件中,通过 patterns 匹配语言元素。

比如,为自定义语言中的关键字 if、else、while 添加蓝色高亮:

{   "name": "keyword.control.mylang",   "match": "b(if|else|while)b" }

为字符串添加绿色:

VSCode语言支持:开发新型编程语言语法扩展包

云雀语言模型

云雀是一款由字节跳动研发的语言模型,通过便捷的自然语言交互,能够高效的完成互动对话

VSCode语言支持:开发新型编程语言语法扩展包54

查看详情 VSCode语言支持:开发新型编程语言语法扩展包

{   "name": "string.quoted.double.mylang",   "begin": """,   "end": """,   "beginCaptures": { "0": { "name": "punctuation.definition.string.begin.mylang" } },   "endCaptures": { "0": { "name": "punctuation.definition.string.end.mylang" } } }

建议参考已有的语言语法文件(如 javaScript 或 python 的 tmLanguage 规则),结合你语言的实际结构逐步构建匹配模式。

测试与调试

按 F5 启动扩展调试窗口,打开一个 .mylang 文件,查看语法高亮是否生效。如果某些部分未正确着色,使用 VSCode 内置的命令:

Developer: Inspect Editor Tokens and Scopes

点击编辑器中的文本,可查看当前词法元素匹配的 scope 名称,据此调整你的 tmLanguage 规则。

发布与分享

完成开发后,在 package.json 中完善描述、图标、标签等信息。使用 vsce 工具打包并发布到 VSCode Marketplace:

vsce publish

确保 LICENSE 和 README.md 齐全,方便其他开发者使用和贡献。

基本上就这些。语法扩展不涉及语言服务器,专注文本呈现层面,适合早期语言原型阶段快速获得良好编辑体验。

上一篇
下一篇
text=ZqhQzanResources