optimize imports仅删除静态分析确认未被引用的普通import，如未使用的命名/默认导入、冗余星号导入及重复路径导入；但不删import type、jsdoc类型引用、动态import及间接用于泛型的命名导入。
Optimize Imports 能清哪些 import，不能清哪些
Optimize Imports（快捷键 Ctrl+Alt+O / Cmd+Option+O）只删当前文件里被静态分析确认“未被引用”的普通 import 语句。它会合并重复导入、删掉未使用的命名导入（如 import { foo, bar } from 'lib' 中 bar 没出现）、清理冗余的 import * as utils（如果 utils 全程没调用）。但它明确不碰：
-
import type—— 即使完全没用，只要tsconfig.json里设了"importsNotUsedAsValues": "error"就保留 - JSDoc 里的类型引用，比如
/** @type {MyType} */用到的import { MyType } from './types' - 动态
import()，例如import(`./pages/${page}.tsx`)，路径含变量就无法静态推断 - 命名导入被间接用于泛型或类型参数，像
import { Options } from 'lib'; const x: Array<options> = [];</options>
批量清理整个项目的 import 怎么操作
默认快捷键只作用于当前打开的文件。要扫整个项目，必须先聚焦 Project 工具窗（点左侧项目树任意空白处），再按 Ctrl+Alt+Q（Win/Linux）或 Cmd+Option+Q（Mac）。弹出对话框后：
- 勾选
Only VCS changed files是最安全的选择——只处理 Git 已跟踪且有修改的文件，避免误动node_modules或第三方配置 - 别选
Entire project直接全扫，尤其当项目含大量.d.ts或构建产物时，可能触发误判 - 它不会改未打开的文件，也不会处理
.json、.md或配置类文件
删未使用变量/函数/类型，不能靠 Optimize Imports
Optimize Imports 对 let unusedVar = 1、function helper() {}、type Foo = string 完全无效。真正管这些的是 WebStorm 的 Inspection 机制：
- 单个清理：光标停在灰色显示的变量/函数上，按
Alt+Enter→Remove unused declaration - 批量扫描：菜单栏
Analyze → Run Inspection by Name，输入unused，选Unused local symbol、Unused function、Unused type declaration，指定范围后运行 - 注意接口（
interface）和类型别名（type）容易被误判——哪怕没直接实例化，只要被其他类型extends或&引用，删了就会破坏类型安全
为什么删完还报错？关键坑在这儿
最常见的不是功能失效，而是删得“太干净”导致运行时崩：
- import 被注释掉了但没删？
Optimize Imports默认忽略注释行，得手动清 - 用了
require()或define()（如 AMD）？它只识别 ES Module 和 CommonJS 的import/export语法 - 删完立刻运行报
Cannot find name 'X'或ReferenceError？说明代码里还有残留引用，比如const x: MyType = {}或console.log(unusedVar)—— 它只删声明，不改使用 - 索引滞后：删前没执行
File → Invalidate Caches and Restart…并勾选Clear file system cache and Local History和Clear VCS Log caches and indexes，可能导致该删的没删、不该删的删了
真正麻烦的从来不是怎么删，而是删完之后运行时突然挂掉——因为有些 import 是给构建工具用的，或者变量是给 typeof、keyof、JSDoc 服务的，静态分析看不见它们的真实用途。
