webstorm无法真正一键删光所有未使用导入和变量，但可通过ctrl+alt+o清理import、alt+enter批量删未用变量；漏网情况包括jsdoc类型引用、动态import、import type及间接类型使用，需配合analyze→run inspection by name全量扫描，并先执行invalidate caches确保索引准确。
WebStorm 无法真正“一键”删光所有未使用导入和变量，但能以接近一键的效率批量处理——前提是索引准确、配置得当、知道哪些情况它会漏掉。
Ctrl+Alt+O 能清 import，但常漏掉这几种
快捷键 Ctrl+Alt+O（Windows/Linux）或 Cmd+Alt+O（macOS）触发 Optimize Imports，它只做静态可达性分析，不运行代码。以下情况它默认放过：
-
import仅出现在 JSDoc 类型注释中，如/** @type {MyType} */—— WebStorm 不解析 JSDoc 引用 - 动态 import 路径含变量，如
import(`./${name}.ts`)—— 字符串拼接绕过静态分析 - TypeScript 中的
import type，尤其当tsconfig.json设了"importsNotUsedAsValues": "error"时，即使没用也会保留 - 命名导入被间接用于类型位置，比如
import { Foo } from 'lib';然后在泛型里写Array<foo></foo>—— 它可能被判定为“已用于类型”，不删
这类漏网项得靠 Analyze → Run Inspection by Name，搜 unused import，选 Whole project 扫描才靠谱。
Alt+Enter 删除单个未用变量，批量操作要这样设
悬停灰色变量名按 Alt+Enter，选 Remove unused declaration 是最稳的单点清理方式。但想批量处理当前文件：
- 把光标放在任意未用变量上，按
Alt+Enter，方向键选Fix all 'Unused local variable' problems in file - 别依赖“修复所有问题”全局按钮——它可能误删测试中用到的变量，或跳过被
extract()/${$key}动态创建的变量 - 确保 PHP/TS 语言级别匹配项目实际版本（
Settings → Languages & Frameworks → PHP或TypeScript），否则短闭包、解构等语法识别失败，$item在foreach里会被误标
Inspection 全局扫描比编辑器高亮更可靠
编辑器右下角提示或行内灰显只是轻量检查，容易滞后或误判。真要清底：
- 右键项目根目录 →
Inspect Code…→ 范围选Whole project，Profile 用Default - 扫描完，在结果窗口展开
JavaScript and TypeScript → Unused symbols或PHP → Unused symbols - 导出 CSV 报告前，先手动排除测试文件夹（加
Test.php或*.spec.ts到 inspection scope exclusion） - 注意：类私有属性
private $cache或private cache: string不会出现在这里，得单独开Unused private field检查
清理前必做：缓存失效不是可选项
如果 Ctrl+Alt+O 不删该删的、Alt+Enter 没反应、或 inspection 结果明显错乱，90% 是索引损坏：
- 执行
File → Invalidate Caches and Restart… - 勾选
Clear file system cache and Local History和Clear VCS Log caches and indexes - 重启后等索引完成（状态栏右下角进度条消失）再操作，否则所有清理动作都建立在错误符号图上
动态 import、JSDoc 类型、子类访问的私有成员——这些不是 WebStorm 的缺陷，而是静态分析的天然边界。你得知道它在哪停步，才能决定下一步是手动删、加 // @ts-ignore，还是补 inspection 扫描。
