VSCode中控制未使用变量颜色的settings.json设置项咨询

未使用变量的颜色控制分为两种场景，取决于它是由语法高亮引擎还是**语言诊断工具（如TS/ESLint/Pylint等）**标记的：

1. 针对语法高亮层面的未使用变量（部分语言原生支持） #

如果你的未使用变量是由VSCode的语法识别直接标记的，可通过editor.tokenColorCustomizations的textMateRules配置，核心是找到对应语言的未使用变量Scope：

操作步骤： #

• 打开命令面板（Ctrl+Shift+P），运行Developer: Inspect Editor Tokens and Scopes
• 鼠标悬停在未使用变量上，查看弹出的Scope列表，找到带unused的条目（比如JS/TS对应meta.declaration.variable.unused，Python可能是variable.other.readwrite.unused.python）
• 在settings.json中添加对应规则：

"editor.tokenColorCustomizations": {
  "textMateRules": [
    {
      "scope": "meta.declaration.variable.unused", // 替换为你查到的实际Scope
      "settings": {
        "foreground": "#888888", // 自定义未使用变量的文字颜色
        "fontStyle": "italic" // 可选：添加斜体等附加样式
      }
    }
  ]
}

2. 针对诊断工具标记的未使用变量（更常见场景） #

大部分情况下，未使用变量是由语言服务（如TypeScript）或第三方Lint工具（如ESLint）作为诊断警告/提示标记的，此时需要通过workbench.colorCustomizations配置诊断样式：

通用诊断样式配置（影响所有未使用类诊断）： #

"workbench.colorCustomizations": {
  "editorWarning.foreground": "#ffaa00", // 未使用变量通常被标记为警告，修改警告文字颜色
  "editorUnnecessaryCode.opacity": "0.6", // 可选：给未使用代码添加透明度
  "editorUnnecessaryCode.background": "#ffff0022" // 可选：给未使用代码添加背景高亮
}

单独区分未使用变量与其他警告（精准控制） #

如果需要单独给未使用变量设置颜色，同样用Inspect Editor Tokens and Scopes查看对应的诊断Scope（比如ESLint生成的eslint.warning.unused-variable），然后添加到textMateRules：

"editor.tokenColorCustomizations": {
  "textMateRules": [
    {
      "scope": "eslint.warning.unused-variable", // 替换为实际查到的Scope
      "settings": {
        "foreground": "#999999"
      }
    }
  ]
}

注意：如果之前配置editor.tokenColorCustomization没成功，大概率是没找对对应的Scope，一定要用Inspect Editor Tokens and Scopes工具确认当前语言/工具对应的具体Scope。

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