webstorm检测冗余变量依赖静态分析而非自动删除，标灰仅表示unused symbol检查提示，需通过alt+enter手动删单个声明或analyze→run inspection by name批量扫描并人工核对误判项。
WebStorm 检测冗余变量不靠快捷键一键清空，而是依赖静态分析引擎对符号引用关系的判断——它标灰不代表能安全删，得看引用是否被 IDE 正确识别。
未使用变量为什么只标灰却不自动删
WebStorm 默认把 const unusedVar = 1、function unusedFn() {}、type UnusedType = string 这类声明标为灰色，但不会自动删除。这是因为：
- 灰色只是
Unused symbol检查项的视觉提示，不是执行动作 - IDE 不运行代码，无法确认
typeof unusedVar、keyof UnusedType或 JSDoc 中的@type {UnusedType}是否构成有效引用 - 动态访问如
obj[unusedVar]或全局挂载如window[unusedVar] = fn会被漏判，IDE 默认不认为它们是“引用”
Alt+Enter 删除单个变量的实际效果
光标停在灰色变量名上按 Alt+Enter（macOS 是 ⌥ + ⏎），选 Remove unused declaration，这是最稳妥的清理方式：
- 只作用于当前声明，不跨作用域，不会误删同名但不同作用域的变量
- 不依赖项目级索引状态，刚改完代码也能立刻响应
- 对
import type、JSDoc 类型引用、泛型参数等干扰场景更鲁棒 - 如果变量被
typeof或keyof引用，通常不会出现在菜单里——说明 IDE 判断它“有用途”，别硬删
批量扫整个项目时容易踩的坑
菜单栏点 Analyze → Run Inspection by Name，输 unused，选 Unused local symbol 或 Unused function 后全项目扫描，要注意：
-
interface被其他类型extends或&引用时，WebStorm 可能误判为未使用——必须人工核对继承链 - TS 配置里若开了
"importsNotUsedAsValues": "error"，import type即使没用也不会被标记，但Unused type declaration检查仍会把它列出来 - 扫描前务必执行
File | Invalidate Caches and Restart…并勾选Clear file system cache，否则索引滞后会导致漏报或误报 - 删完立刻全局搜索该名称（
Ctrl+Shift+F），确认没有残留引用，否则会爆出Cannot find name 'XXX'
真正难处理的不是标灰的变量，而是那些没被标灰、但实际已失效的类型别名或导出——它们可能被间接依赖，删了不报错，但类型安全就断了。
