VSCode : 如何禁用评论中的 doxygen 标签突出显示?

VSCode : how to disable doxygen tags highlight in comments?

在没有扩展名的 VSCode 中,C 文件的颜色如下:

红色方块是我遇到的问题。我发现使用与源代码相同的颜色来注释会让人分心。我想找到一种方法来禁用 doxygen 高光,或者至少抑制它的颜色以减少它的视觉影响。

为了抑制它,我一直在使用 editor.tokenColorCustomizations 属性(如 Microsoft 记录的 here)来更改其颜色,但我无法定位到正确的组。

对我来说更好的解决方案是禁用所有 Doxygen 突出显示。无论如何,我们将不胜感激!

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

  1. 将光标放在视觉上令人讨厌的元素上。
  2. Ctrl+Shift+P 访问调色板并搜索 Developer: Inspect TM Scopes。 Select它。
  3. 在工具提示底部的项目符号列表中检索信息。
  4. 编写一个 textMateRules,其范围与工具提示范围匹配。

对于 Doxygen,settings.json 文件中的以下 Textmate 规则会使用自定义颜色重新着色 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 时出现得更多。 and its linked issue 让我想到了这个解决方案。