optimize imports仅清理当前文件中未被引用的import语句，包括未使用的命名导入、冗余的星号导入及重复导入，但不处理type导入、动态import()及变量/函数定义。
Optimize Imports 能删掉哪些 import？
它只清理当前文件里真正没被引用的 import 语句，包括：import { foo } from 'bar' 中未使用的 foo、整个 import * as utils from './utils'（如果 utils 没出现过）、重复导入（如两次 import React from 'react' 会合并）。不会碰 type 导入（除非开启 TypeScript 的 allowUnusedLabels 类似检查），也不会动动态 import() 表达式。
批量清理整个项目的 import 怎么操作？
默认快捷键 Ctrl+Alt+O（Win/Linux）或 Cmd+Option+O（Mac）只作用于当前打开的文件。要扫整个项目：
- 先点左侧
Project工具窗任意空白处，确保它获得焦点 - 按
Ctrl+Alt+Q（Win/Linux）或Cmd+Option+Q（Mac） - 在弹出对话框中选范围：推荐勾选
Only VCS changed files，避免误改未提交的依赖文件 - 点击
Run，WebStorm 会逐个处理匹配的.ts和.js文件
注意：这个操作不修改未纳入 Git 跟踪的文件，也不处理 .d.ts 或配置类文件。
删未使用变量/函数/类型，不能只靠 Optimize Imports
Optimize Imports 不管变量或函数定义是否被用——那是代码检查（Inspection）的事。正确做法是：
- 把光标停在灰色显示的未用变量上，按
Alt+Enter，选Remove unused declaration - 想全局扫一遍：菜单栏
Analyze → Run Inspection by Name，输unused，选Unused local symbol、Unused function、Unused type declaration等 - 指定范围后运行，结果列表支持多选 + 右键
Apply fix批量删
特别注意：接口或 type 定义即使没直接使用，但被其他类型 extends 或 & 引用时，WebStorm 可能误判为“未使用”，得人工核对。
为什么删完 import 还报错？常见坑在这儿
最常踩的不是功能没起作用，而是没意识到这些边界：
-
import被注释掉了但没删？Optimize Imports默认忽略注释行，得手动清 - 用了
require()或define()（比如 AMD）？它只处理 ES Module 和 CommonJS 的import/export语法 - TypeScript 中带
type修饰的导入，如import type { Foo } from './types'，默认不参与清理——得在Settings → Editor → Inspections → TypeScript → Unused symbol里单独开检查 - 某些插件（如 Angular Language Service）可能缓存旧符号，删完 import 后建议重启 WebStorm 或执行
File → Invalidate Caches and Restart
真正麻烦的从来不是怎么删，而是删完之后运行时突然 ReferenceError——因为有些 import 是给构建工具（如 Webpack 的 require.context）或运行时反射（如 Reflect.getMetadata）用的，静态分析根本看不见。
