如何在WebStorm中一键清理项目中未使用的Import导入？
代码里堆满了用不上的 import 语句，看着碍眼，还可能影响编译？这事儿其实有现成的“一键瘦身”方案。
用 Optimize Imports 快速删掉无用 import
WebStorm 虽然没有一个叫“全局删除所有未使用 import”的独立命令，但别急，Optimize Imports 这个功能就是你要找的完美替代。它会自动扫描当前文件，把所有没被实际引用的 import 语句清理掉，顺手还能帮你把剩下的 import 排个序、合并一下重复项。
怎么触发它？有三种方式，最推荐的当然是快捷键：
- 把光标放在文件任意位置，直接按
Ctrl+Alt+O（Windows/Linux）或者Cmd+Option+O（macOS）。 - 从顶部菜单栏选择
Code | Optimize Imports。 - 在编辑区右键，也能找到
Optimize Imports的选项。
不过得注意，这个操作默认只针对你当前打开的这个文件。想给整个项目来个大扫除？那得看下一部分。
批量优化多个文件甚至整个项目的 import
当然可以对整个项目运行 Optimize Imports，只是步骤稍微多一步，需要先聚焦到项目工具窗口：
- 首先，确保左侧的
Project工具窗口已经获得焦点（简单点，用鼠标点击一下项目树结构的空白处就行）。 - 然后，按下快捷键
Ctrl+Alt+Q（Windows/Linux）或Cmd+Option+Q（macOS），这时会弹出一个对话框。 - 如果只想清理那些已经被 Git 跟踪并且有改动的文件，可以勾选
Only VCS changed files这个选项。 - 最后点击
Run，IDE 就会开始逐个扫描并优化你选定范围内的 TypeScript 或 Ja vaScript 文件了。
这个过程是安全的。它不会去改动那些你根本没打开过的文件，除非你特意在对话框里选择了某个目录或模块。所以，完全不用担心会误删生产环境的关键代码。
为什么有些 import 没被删掉？常见漏网原因
话说回来，Optimize Imports 也不是全知全能的。在下面这几种情况下，有些 import 语句即使看起来没被使用，也会被保留下来：
- import 的类型仅仅用在 JSDoc 注释里，比如
/** @type {MyType} */—— WebStorm 默认不会去分析 JSDoc 注释中的类型引用。 - import 来自动态的
import()或者用字符串拼接的路径（例如import(`./${name}.ts`)），静态分析工具很难识别这种动态引用。 - TypeScript 中的
import typeimportsNotUsedAsValues: error的时候）。 - 某些第三方库的命名导入（像
import { foo } from 'bar'），如果foo只是在类型位置被间接使用（比如作为泛型参数），也可能逃过检测。
遇到这些“漏网之鱼”，就得靠手动补刀了。可以使用 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，等待 IDE 重启并完成右下角显示的Indexing…过程后，再进行操作。
记住，在索引重建完成之前，所有基于代码引用的分析（包括 import 识别）都可能是不可靠的。这一点很容易被忽略，但它恰恰是大多数“删不干净”问题的根本原因。
