Optimize Imports可快速删除当前文件无用import，快捷键为Ctrl+Alt+O（Win/Linux）或Cmd+Option+O（Mac）；批量处理需聚焦Project工具窗后按Ctrl+Alt+Q运行。
用 Optimize Imports 快速删掉无用 import
WebStorm 本身不提供“一键全局删除所有未使用 import”的独立命令，但 Optimize Imports 就是你要找的等效操作——它会自动移除当前文件中所有未被引用的 import 语句，并按需排序、合并重复项。
触发方式有三种，推荐用快捷键：
- 光标放在任意位置，按
Ctrl+Alt+O（Windows/Linux）或Cmd+Option+O（macOS） - 菜单栏选择
Code | Optimize Imports - 右键编辑区 →
Optimize Imports
注意：该操作默认只作用于当前打开的文件。如果想批量处理整个项目，得配合下一步。
批量优化多个文件甚至整个项目的 import
直接对整个项目运行 Optimize Imports 是可行的，但需要先打开项目工具窗口（Project 工具窗），再执行操作：
- 确保
Project工具窗已聚焦（点击左侧项目树任意空白处） - 按
Ctrl+Alt+Q（Windows/Linux）或Cmd+Option+Q（macOS），弹出对话框 - 勾选
Only VCS changed files（如果你只想清理 Git 已跟踪且有修改的文件） - 点击
Run，IDE 会逐个扫描并优化所选范围内的 TS/JS 文件
这个过程不会改写未打开的文件，除非你明确在对话框里选了目录或模块——所以不用担心误删生产代码。
为什么有些 import 没被删掉？常见漏网原因
Optimize Imports 不是万能的，以下情况会导致 import 被保留，即使看起来没用：
- import 的类型仅用于 JSDoc 注释，比如
/** @type {MyType} */—— WebStorm 默认不分析 JSDoc 中的类型引用 - import 来自动态
import()或字符串拼接路径（如import(`./${name}.ts`)），静态分析无法识别 - TS 中的
import type即使未使用，也可能被保留（尤其当启用了importsNotUsedAsValues: error的 tsconfig 配置时） - 某些第三方库的命名导入（如
import { foo } from 'bar'）若foo在类型位置被间接使用（例如泛型参数），也可能逃过检测
这类 case 得靠 Analyze | Run Inspection by Name 手动补刀，搜 unused import 并全量检查。
清理前务必确认：缓存和索引是否最新
如果 Optimize Imports 行为异常（比如该删的不删、不该删的删了），大概率不是功能问题，而是 IDE 的符号索引滞后或损坏：
- 先执行
File | Invalidate Caches and Restart… - 勾选
Clear file system cache and Local History和Clear VCS Log caches and indexes - 点
Invalidate and Restart，等右下角Indexing…完全结束再操作
索引重建完成前，所有基于引用的分析（包括 import 识别）都不可靠。这点容易被忽略，但恰恰是多数“删不干净”问题的根源。
