如何在VS Code中禁用JSDoc注释的多色高亮显示？

你猜的完全没错，核心就是修改editor.tokenColorCustomizations配置——VS Code内置的JSDoc语法高亮属于原生TextMate token规则，就算禁用所有扩展也不会影响它，所以得直接覆盖这些token的颜色设置。

按照以下步骤操作就能搞定：

1. 打开VS Code设置界面：按下Ctrl+,（Windows/Linux）或Cmd+,（Mac）。
2. 在搜索框输入Editor: Token Color Customizations，定位到对应的设置项。
3. 点击右侧的Edit in settings.json，进入配置文件编辑模式。
4. 添加以下配置代码，把所有JSDoc相关元素统一映射到默认注释颜色：

"editor.tokenColorCustomizations": {
  "textMateRules": [
    {
      "scope": [
        "comment.block.documentation",
        "comment.block.documentation.js",
        "comment.block.documentation.ts",
        "jsdoc.tag",
        "jsdoc.paramName",
        "jsdoc.type",
        "jsdoc.typeName",
        "jsdoc.value",
        "jsdoc.comment"
      ],
      "settings": {
        "foreground": "${commentForeground}"
      }
    }
  ]
}

关键细节说明： #

• 用${commentForeground}变量的好处是，它会自动匹配当前主题的默认注释颜色，不用手动写固定十六进制色值，完美适配所有浅色/深色主题。
• 上面的scope列表覆盖了JSDoc中所有常见的高亮元素：包括整个文档注释块、@标签、参数名、类型、值等，确保所有JSDoc内容都和普通注释颜色完全统一。

5. 保存settings.json后，按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），执行Reload Window命令，让设置立即生效。

如果之后还有个别JSDoc元素没被覆盖，你可以用VS Code的「Inspect Editor Tokens and Scopes」工具排查：按下Ctrl+Shift+P搜索并执行该命令，点击要检查的JSDoc文本，就能看到它对应的token scope，把这个scope添加到上面的列表里即可。

内容的提问来源于stack exchange，提问作者Bradley Singer