VSCode针对特定令牌类型用语法高亮覆盖语义高亮的方法

要在保留大部分语义高亮的同时，让特定令牌（如class、static、void、string）改用TextMate语法高亮差异化显示，可按以下两种场景处理：

场景1：语义令牌有细分类型（推荐） #

如果你的语言扩展对目标令牌有更细致的语义分类（比如class属于keyword.control.class而非单纯的keyword），可以通过精准的语义令牌规则让这些令牌继承TextMate颜色：

在settings.json中添加：

"editor.semanticTokenColorCustomizations": {
  "rules": {
    // 保留其他keyword的语义高亮颜色
    "keyword": "#[你的通用keyword颜色]",
    // 让目标令牌继承TextMate语法高亮的颜色
    "keyword.control.class": { "color": "inherit" },
    "keyword.modifier.static": { "color": "inherit" },
    "keyword.type.void": { "color": "inherit" },
    "keyword.type.string": { "color": "inherit" }
  }
}

这样，只有指定的令牌会放弃语义高亮颜色，改用TextMate的规则，其他令牌的语义高亮不受影响。

场景2：语义令牌无细分类型（所有目标令牌都被标为keyword） #

如果语言扩展把所有目标令牌都统一标为keyword，无法通过语义类型区分，可采用以下方法：

1. 先在semanticTokenColorCustomizations中移除通用的keyword规则，避免覆盖TextMate：

"editor.semanticTokenColorCustomizations": {
  "rules": {
    // 不要设置"keyword": "[颜色]"
    // 仅给你想保留语义高亮的令牌设置颜色，比如函数名、变量等
    "function": "#[函数颜色]",
    "variable": "#[变量颜色]"
  }
}

2. 然后在editor.tokenColorCustomizations中配置TextMate规则，给目标令牌设置差异化颜色：

"editor.tokenColorCustomizations": {
  "textMateRules": [
    {
      "scope": "storage.type.class",
      "settings": {
        "foreground": "#[class的颜色]"
      }
    },
    {
      "scope": "storage.modifier.static",
      "settings": {
        "foreground": "#[static的颜色]"
      }
    },
    {
      "scope": "storage.type.void",
      "settings": {
        "foreground": "#[void的颜色]"
      }
    },
    {
      "scope": "storage.type.string",
      "settings": {
        "foreground": "#[string的颜色]"
      }
    }
  ]
}

这种方法虽然需要手动配置TextMate作用域，但能精准控制目标令牌的高亮，同时保留其他令牌的语义高亮效果。

验证方法 #

按Ctrl+Shift+P打开命令面板，输入Developer: Inspect Editor Tokens and Scopes，点击目标令牌，查看其语义令牌类型和TextMate作用域，确保配置的规则匹配正确。

内容的提问来源于stack exchange，提问作者Ozelot Vanilla