为自己的脚本语言编写VSCode支持扩展：从零到发布完整指南#

1
{
2
    "name": "my-language-support",
3
    "displayName": "My Language Support",
4
    "description": "Syntax highlighting for My Language",
5
    "version": "1.0.0",
6
    "publisher": "your-name",
7
    "engines": { "vscode": "^1.75.0" },
8
    "categories": ["Programming Languages"],
9
    "contributes": {
10
        "languages": [{
11
            "id": "mylang",
12
            "aliases": ["My Language", "mylang"],
13
            "extensions": [".mylang", ".ml"],
14
            "configuration": "./language-configuration.json"
15
        }],
16
        "grammars": [{
17
            "language": "mylang",
18
            "scopeName": "source.mylang",
19
            "path": "./syntaxes/mylang.tmLanguage.json"
20
        }]
21
    }
22
}

1
{
2
    "$schema": "https://raw.githubusercontent.com/martinring/tmlanguage/master/tmlanguage.json",
3
    "scopeName": "source.mylang",
4
    "patterns": [
5
        {
6
            "name": "comment.line.mylang",
7
            "match": "//.*"
8
        },
9
        {
10
            "name": "keyword.control.mylang",
11
            "match": "\\b(if|else|while|for|return)\\b"
12
        },
13
        {
14
            "name": "constant.numeric.mylang",
15
            "match": "\\b\\d+(\\.\\d+)?\\b"
16
        }
17
    ]
18
}

1
{
2
    "comments": {
3
        "lineComment": "//",
4
        "blockComment": ["/*", "*/"]
5
    },
6
    "brackets": [
7
        ["{", "}"],
8
        ["[", "]"],
9
        ["(", ")"]
10
    ],
11
    "autoClosingPairs": [
12
        { "open": "{", "close": "}" },
13
        { "open": "[", "close": "]" },
14
        { "open": "(", "close": ")" },
15
        { "open": "\"", "close": "\"" }
16
    ],
17
    "indentationRules": {
18
        "increaseIndentPattern": "^.*\\{[^}\"]*$|^.*\\([^)\"]*$",
19
        "decreaseIndentPattern": "^\\s*\\}|^\\s*\\)"
20
    }
21
}

1
{
2
    "scopeName": "source.pgn",
3
    "patterns": [
4
        // 注释
5
        {
6
            "name": "comment.line.double-slash.pgn",
7
            "match": "//.*"
8
        },
9

10
        // 命令（小心处理边界）
11
        {
12
            "name": "keyword.control.pgn",
13
            "match": "(?<!\\$\\{)\\b(say|wait|set|if|choose)\\b(?!\\})"
14
        },
15

16
        // 变量引用
17
        {
18
            "name": "variable.parameter.pgn",
19
            "begin": "\\$\\{",
20
            "end": "\\}",
21
            "patterns": [
22
                {
23
                    "name": "variable.other.pgn",
24
                    "match": "[a-zA-Z_][a-zA-Z0-9_]*"
25
                }
26
            ]
27
        },
28

29
        // 标签定义（行首的单词后跟冒号）
30
        {
31
            "name": "entity.name.tag.pgn",
32
            "match": "^\\s*[A-Za-z_][A-Za-z0-9_]*:"
33
        }
34
    ]
35
}

1
{
2
    "contributes": {
3
        "commands": [{
4
            "command": "mylang.formatDocument",
5
            "title": "Format MyLang Document"
6
        }],
7
        "configuration": {
8
            "title": "My Language",
9
            "properties": {
10
                "mylang.enableSyntaxHighlighting": {
11
                    "type": "boolean",
12
                    "default": true,
13
                    "description": "Enable syntax highlighting"
14
                }
15
            }
16
        }
17
    },
18
    "activationEvents": [
19
        "onLanguage:mylang",
20
        "onCommand:mylang.formatDocument"
21
    ]
22
}

1
// 创建Language Server
2
import * as vscode from 'vscode';
3
import * as lsp from 'vscode-languageclient';
4

5
export function activate(context: vscode.ExtensionContext) {
6
    const serverOptions: lsp.ServerOptions = {
7
        command: 'node',
8
        args: [context.asAbsolutePath('server/server.js')]
9
    };
10

11
    const clientOptions: lsp.LanguageClientOptions = {
12
        documentSelector: [{ scheme: 'file', language: 'mylang' }]
13
    };
14

15
    const client = new lsp.LanguageClient(
16
        'mylangServer',
17
        'My Language Server',
18
        serverOptions,
19
        clientOptions
20
    );
21

22
    client.start();
23
}

1
// 错误：过于复杂的正则
2
"match": "\\b(say|wait|show|end|set|random|jump|if|choose|endname|SAY|WAIT|SHOW|END|SET|RANDOM|JUMP|IF|CHOOSE|ENDNAME)\\b"
3

4
// 优化：使用忽略大小写标志
5
"match": "(?i)\\b(say|wait|show|end|set|random|jump|if|choose|endname)\\b"

1
// 变量引用内部的文本不应该被当作命令高亮
2
// 错误：${say} 中的 "say" 被高亮为命令
3
// 解决：在命令匹配中使用负向零宽断言
4
"match": "(?<!\\$\\{)\\b(say|wait|set)\\b(?!\\})"