Optimize Imports仅删除静态分析确认“完全未使用”的import，如未引用的命名导入、未使用的命名空间导入、重复路径导入等，但保留类型导入、JSDoc引用、动态import及参与泛型的类型；项目级清理需Ctrl+Alt+Q并勾选VCS变更文件；索引滞后可能导致误删，建议清缓存重启。
Ctrl+Alt+O（Windows/Linux）或 Cmd+Option+O（macOS）就能删掉当前文件里真正没用的 import，但不是所有灰色 import 都会被清掉——WebStorm 不运行代码，只靠 AST 静态分析。
Optimize Imports 能删哪些 import？
它只动那些被静态分析确认「完全没出现过」的导入：
-
import { foo } from 'lib'中foo在 JS/TS 代码里一次都没被引用（包括变量名、函数调用、类型注解位置） -
import * as utils from './utils'，但utils这个名字在文件中从未出现 - 重复路径导入，比如两个
import { bar } from 'pkg'，会合并成一条 - 刚删掉某个变量，对应
import { baz } from 'pkg'也可能被顺带清理
但它明确不碰这些：
-
import type { MyType } from './types'—— 即使没用，只要tsconfig.json里设了"importsNotUsedAsValues": "error"就保留 - JSDoc 里的类型引用，比如
/** @type {MyType} */用到的导入 -
import(`./pages/${page}.tsx`)这种动态路径，AST 无法推断page值 -
import { Options } from 'lib'; const x: Array<options> = [];</options>—— 类型虽未直接使用，但参与泛型构造，会被视为已用
批量清理整个项目中的冗余 import
默认快捷键只作用于当前打开的文件。要扫整个项目，得走 Project 工具窗流程：
- 点击左侧
Project工具窗任意空白处，确保它获得焦点 - 按
Ctrl+Alt+Q（Windows/Linux）或Cmd+Option+Q（macOS） - 对话框里勾选
Only VCS changed files（推荐），避免误改未提交的依赖文件 - 点
Run，WebStorm 会逐个处理匹配的.ts和.js文件
注意：这个操作不会改写未纳入 Git 跟踪的文件，也不会处理 .d.ts 或配置类文件。
为什么 Ctrl+Alt+O 有时不生效或删错？
大概率不是功能失效，而是 IDE 符号索引滞后或损坏：
- 刚改完代码，IDE 还没刷新索引 → 此时
Ctrl+Alt+O可能漏删或误删 - Mac 版 WebStorm 必须先执行
File | Invalidate Caches and Restart…，并勾选Clear file system cache and Local History和Clear VCS Log caches and indexes - 某些插件（如 Angular Language Service）缓存旧符号，删完 import 后建议重启 WebStorm
- 用了
require()或define()（比如 AMD 模块）？Optimize Imports只识别 ES Module 和 CommonJS 的import/export语法
Alt+Enter 比 Ctrl+Alt+O 更精准的场景
悬停在灰色变量或导入上按 Alt+Enter，选 Remove unused declaration，是逐项确认式清理：
- 适合只想删某一个 import，而不是整文件重排
- 怀疑某个 import 被“误判为已使用”，比如它只出现在注释或未激活的条件分支里
- 批量删当前文件所有未用变量，可把光标放在任意灰色变量上，按
Alt+Enter→ 方向键选Fix all 'Unused local variable' problems in file；但别直接点顶部的“Fix all”按钮——它可能跳过被模板字符串或eval动态引用的变量
真正容易被忽略的是：interface 或 type 别名哪怕没直接实例化，只要被其他类型 extends 或 & 引用，就不是真冗余——盲目批量删可能破坏类型安全。
