webstorm中快速定位当前文件未用变量：变量/函数/类型被标灰并悬停显示“unused”提示，光标停在变量名上按alt+enter选“remove unused declaration”即可删除，该操作仅作用于当前声明且不跨作用域。
怎么快速定位当前文件里未使用的变量
WebStorm 会把未被读取或调用的 let、const、var 变量、function 声明、type 和 interface 标成灰色，并在悬停时显示 “unused local variable” 类提示。这不是猜测，而是基于作用域和引用链的静态分析结果。
光标停在灰色变量名上，按 Alt+Enter，选 Remove unused declaration 即可删掉它——这个操作只影响当前声明，不跨函数或模块，也不会动 import 或注释。
- 若变量被
typeof、keyof、泛型参数（如T extends typeof x）或 JSDoc@type引用，WebStorm 通常不会标记为未使用 - 类成员（
private field）若只在装饰器或元数据中出现（如@Input()），可能被误判，需人工确认 - 箭头函数赋值给变量（
const fn = () => {}）和function声明都支持该快捷删，但 IIFE 内部的变量不在此列
如何批量扫整个项目里的未用变量和类型
菜单栏点 Analyze → Run Inspection by Name，输入 unused，从列表里选三项：
-
Unused local symbol：删函数内部未用的let/const、参数、catch绑定 -
Unused function：删顶层或模块级未被调用的function声明（不含导出函数） -
Unused type declaration：删没被type、interface、class或泛型约束直接/间接引用的类型定义
范围选 Entire project 后点击 OK，结果以列表形式弹出，支持多选 + 右键 Apply fix 批量删除。注意：interface A extends B 中若 B 没被其他地方显式引用，WebStorm 可能把它标为未使用——但它其实是 A 的结构依赖，删了会导致 A 报错。
为什么有些“看着没用”的变量没被标灰
WebStorm 的 Unused symbol 检查不是靠“有没有 console.log(x)”这种简单扫描，而是依赖符号可达性分析。以下情况它大概率放过：
- 通过动态属性访问：如
obj[variableName]中的variableName是拼接字符串或变量，无法静态推导 key - 挂到全局对象上：如
window.myFn = () => {}，默认不认为有外部引用，但若项目配置了globals或用了/* global myFn */注释，就能识别 - 被框架元数据隐式使用：Vue 的
setup()返回值、React 组件名、Angular 的@Component类，若 WebStorm 未正确识别框架上下文（比如缺少@angular/core类型定义），就可能误判 - ESLint 开启且规则冲突：如果
no-unused-vars关闭了某些检查项，而 WebStorm 的内置检查又让位于 ESLint，那高亮就会消失——临时关掉 ESLint（Settings | Languages & Frameworks | JavaScript | Code Quality Tools | ESLint）可验证是否为此原因
删完之后最该立刻做的事
删掉变量或类型后，WebStorm 不会自动清理它的所有引用。残留的 console.log(unusedVar) 或 const x: MyType = {} 会立刻报 Cannot find name 'unusedVar' 或 Cannot find name 'MyType' 错误——这不是功能 bug，而是设计使然。
真正容易被忽略的是：类型系统里的间接依赖链。比如一个 type 没被直接实例化，但被另一个 type 用 & 合并、被 extends 继承、或作为泛型参数传入库函数，它就不是冗余项。盲目批量删，可能让 TS Server 在后续编辑中突然爆大量类型错误，而你得花时间反向追溯哪条依赖断了。
