vscode自定义关键字 _ VSCode自定义关键字高亮颜色的textMateRules配置方法-VSCode-PHP中文网

VS Code 的 editor.tokenColorCustomizations 无法高亮自定义关键字，因其仅能覆盖已有 token 类型，不能创建新 scope；必须通过 TextMate 语法注入或完整语法扩展先生成对应 scope（如 keyword.custom.constant），再用 textMateRules 配色。

vscode自定义关键字 _ vscode自定义关键字高亮颜色的textmaterules配置方法

VS Code 无法通过 editor.tokenColorCustomizations 直接高亮自定义关键字，必须用 TextMate 语法注入（injectionSelector）或扩展语法文件 + textMateRules 配合生效。

为什么 `tokenColorCustomizations` 对自定义关键字无效

VS Code 的 editor.tokenColorCustomizations 只能覆盖已有 token 类型（如 keyword、support.function），不能凭空创建新 token。你写的 myKeyword 如果没被语法解析器识别为某个 scope，再怎么配 textMateRules 都不会命中。

常见错误现象："scope": "myKeyword" 完全不生效，关键词颜色毫无变化
根本原因：TextMate 规则靠 scope 字符串匹配，而默认的 JavaScript/Python 等语法不产出 myKeyword 这类 scope
验证方法：打开命令面板 → Developer: Inspect Editor Tokens and Scopes，把光标停在目标词上，看右下角显示的实际 scope 列表

正确做法：用 `injectionSelector` 注入自定义 scope

适用于想在特定语言（如 JavaScript）中高亮一组固定单词（如 TODO、FIXME、API_V1），且不想写完整语法扩展的情况。

新建 ~/.vscode/extensions/custom-keywords-0.0.1/syntaxes/inject-custom-keywords.json
内容需包含 injectionSelector（例如 "L:source.js" 表示注入到 JS 文件）和 patterns 匹配规则
关键点：每个 match 必须输出一个明确 scope，如 keyword.custom.api，后续才能被 textMateRules 捕获

示例片段（匹配大写蛇形常量）：

{
  "injectionSelector": "L:source.js",
  "patterns": [
    {
      "match": "\b[A-Z][A-Z_0-9]*\b",
      "name": "keyword.custom.constant"
    }
  ]
}

如何用 `textMateRules` 绑定颜色

只有当上面的 injection 成功产出 scope 后，这条配置才起作用。它不是独立生效的开关，而是“染色器”。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

在 settings.json 中添加：

"editor.tokenColorCustomizations": {
  "textMateRules": [
    {
      "scope": "keyword.custom.constant",
      "settings": {
        "foreground": "#ff6b6b",
        "fontStyle": "bold"
      }
    }
  ]
}

scope 值必须与 injection 中的 name 完全一致（包括大小写和点号）
多个规则按数组顺序匹配，靠前的规则优先级更高；避免 scope 冲突（比如同时匹配 keyword 和 keyword.custom.constant）
不支持正则 scope，不支持通配符（keyword.custom.* 无效）