ctrl+alt+o仅静态清理当前文件import，执行重排、合并与解构转换，但漏掉jsdoc类型引用、动态import及import type（除非手动启用对应设置），需配合run inspection by name扫描残留并清除缓存确保索引准确。
Ctrl+Alt+O 不是“删无用 import”的银弹，它只做静态分析能覆盖的部分，动态引用、JSDoc 类型、TS 类型导入都可能漏掉——别信一键清理，得配合手动检查。
Ctrl+Alt+O 实际干了什么？不是简单删，而是重排+合并+转形
这个操作默认会：
• 按字母序重排所有 import 语句
• 合并同源导入，比如把 import { a } from './x'; import { b } from './x'; 合成 import { a, b } from './x';
• 若启用了 “Use destructuring for namespace imports” 设置，import * as utils from './utils'; 可能被转成 import { foo, bar } from './utils';
• import type 默认不参与清理，除非你在 Settings → Editor → General → Auto Import 中勾选了 Remove unused imports for types
为什么有些 import 明明没用却删不掉？
常见漏网原因：
• import 仅用于 JSDoc 注释，例如 /** @type {MyType} */ —— WebStorm 默认不解析 JSDoc 中的类型引用
• 动态导入路径含变量或拼接，如 import(`./${name}.ts`) 或 import('./' + path)，静态分析无法追踪
• TS 配置中启用了 "importsNotUsedAsValues": "error"，此时 import type 即使未使用也会保留
• 命名导入被间接用在类型位置，比如 function fn<t extends somelib.type>(x: T)</t>，SomeLib.Type 所在的 import 就不会被识别为“未使用”
删完还得补刀：Run Inspection by Name 扫描残留
Optimize Imports 失效时，别急着重启 IDE，先手动触发深度检查：
• 按 Ctrl+Shift+A → 输入 Run Inspection by Name
• 搜 unused import，选中 Unused import statement 并运行
• 它能识别 JSDoc 和部分类型上下文中的引用，比 Ctrl+Alt+O 更严格
• 注意：若项目刚改过 tsconfig.json 或新增了类型定义，务必先执行 File | Invalidate Caches and Restart…，勾选 Clear file system cache and Local History，否则索引滞后会导致误报或漏报
和 ESLint 冲突怎么办？别硬扛，对齐配置
如果你开了 eslint-plugin-import/no-unused-vars，而 Ctrl+Alt+O 清理后 ESLint 还报错，说明两者规则不一致：
• WebStorm 的清理逻辑依赖自身符号解析，ESLint 依赖 AST 分析，二者路径不同
• 关键参数要对齐：Settings → Languages & Frameworks → JavaScript → Code Quality Tools → ESLint → Run for files，确保启用且配置文件路径正确
• 推荐关闭 WebStorm 的自动优化（Settings → Editor → General → Auto Import → uncheck “Optimize imports on the fly”），改用 ESLint 的 --fix 统一处理，避免来回打架
• 特别注意 import type 场景：ESLint 默认不检查类型导入，需显式开启 typescript-eslint/no-unused-vars 并配 argsIgnorePattern: "^_" 等规则
真正干净的代码不是靠一次快捷键，而是每次 Ctrl+Alt+O 之后，多看一眼编辑器底部状态栏是否提示 “1 unused import”，再顺手点开 Inspection 结果扫两眼——那几行看似安静的 import，往往藏着最隐蔽的耦合。
