VSCode: 如何在注释中禁用Doxygen标签高亮显示？

Question

在没有扩展的情况下，VSCode中的C文件颜色如下：

红色方框是我遇到的问题所在。我发现使用与源代码相同颜色的注释会分散注意力。我希望找到一种方法来禁用 doxygen 高亮，或者至少减弱其颜色以减小其视觉影响。

为了减轻它的影响，我一直在尝试使用 editor.tokenColorCustomizations 属性进行调整（如 Microsoft 在 此处 中记录的那样）来更改其颜色，但我无法定位到正确的组。

对我而言，更好的解决方案是禁用所有 doxygen 高亮。无论如何，任何帮助都将不胜感激！

- jihems

Answer 1

一般来说，在VSCode编辑器中修改项目的颜色如下：

1. 将光标放在视觉上不舒服的元素上。
2. 按下 Ctrl+Shift+P 来访问面板并搜索 Developer: Inspect TM Scopes。选择它。
3. 检索工具提示底部的项目符号列表中的信息。
4. 编写一个文本规则，其范围与工具提示范围相匹配。

对于Doxygen，以下 Textmate 规则在 settings.json 文件中使用自定义颜色重新着色 Doxygen 关键字：

"editor.tokenColorCustomizations": {
  "textMateRules": [
    {
      "scope":"storage.type.class.doxygen",
      "settings": {
        "foreground": "#6272A4"
      }
    }
  ]
}

然而，这只会重新设置@param标签的颜色。对于参数名称，我们应该按照初始列表进行处理，并添加以下规则以覆盖其主题颜色：

  {
    "scope": "variable.parameter.c,comment.block.documentation.c",
    "settings": {
      "foreground": "#6272A4"
    }
  }

我希望这对其他人有用。值得注意的是，当搜索JSDoc而不是Doxygen时，此问题会更加突出。 这个线程及其相关问题使我能够构思出这个解决方案。

- jihems