如何在VS Code中自定义Tooltip（含Python文档字符串）的文本颜色？

一、通过语法主题自定义（原生支持） #

VS Code的Tooltip文本颜色由当前语法主题的token规则控制，你看到的"class"有颜色是因为它被识别为特定语法token。要自定义文档字符串内部分文本的颜色，可按以下步骤操作：

1. 打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入Developer: Inspect Editor Tokens and Scopes并打开。
2. 将鼠标悬停在Tooltip中需要修改颜色的文本上，查看对应的scope（比如Python文档字符串中的警告文本可能对应string.quoted.docstring.python下的子scope，需以实际检测结果为准）。
3. 在settings.json中添加editor.tokenColorCustomizations配置，针对查到的scope设置颜色：

   "editor.tokenColorCustomizations": {
     "[你的主题名称]": {
       "textMateRules": [
         {
           "scope": "string.quoted.docstring.python meta.severity.warning.python", // 替换为实际检测到的scope
           "settings": {
             "foreground": "#FF9800" // 自定义目标颜色
           }
         }
       ]
     }
   }
   

   注意：如果文档字符串内的目标文本未被语法解析识别为特定scope，这种方法无法生效，需要借助插件增强解析能力。

二、借助插件实现精细化控制 #

如果原生语法解析无法区分文档字符串内的特定内容，推荐以下插件：

• Better Comments：支持在文档字符串内通过特定标记（如//!）标记警告类内容，可自定义标记对应的颜色。安装后在settings.json中配置：

  "better-comments.tags": [
    {
      "tag": "!",
      "color": "#FF2D00",
      "strikethrough": false,
      "underline": false,
      "backgroundColor": "transparent",
      "bold": true
    }
  ]
  

  之后在文档字符串中用!标记需要高亮的内容，Tooltip内的对应文本就会显示自定义颜色。
• Python Docstring Generator：可规范文档字符串格式（如Google/NumPy风格），部分主题会对规范格式下的标记（如Warning:）提供单独token识别，配合editor.tokenColorCustomizations即可实现颜色自定义。

三、注意事项 #

• 不同主题的token scope存在差异，必须用Inspect Editor Tokens and Scopes工具确认目标文本的准确scope。
• 使用插件时，需确保插件配置与你的文档字符串风格匹配，部分插件需手动指定风格才能生效。

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