WebStorm可一键清理Vue项目无用import，但需文件被正确认为.vue/.ts且索引最新；Optimize Imports在.vue中失效常见于<script setup>未识别、lang="ts"缺失、索引未完成或动态import导致静态分析失效。
WebStorm 能一键清理 Vue 项目里的无用 import，但必须满足两个前提：文件被正确识别为 .vue 或 .ts，且符号索引是新鲜的——否则删得不准，甚至误删。
为什么 Optimize Imports 在 .vue 文件里有时不生效？
WebStorm 对 .vue 文件的 import 分析依赖于语言服务是否启用并完成索引。常见失效场景包括：
- 单文件组件中
<script setup>语法未被识别（检查右下角状态栏是否显示Vue或TypeScript，不是Plain Text） -
script标签没写lang="ts"，导致 WebStorm 按 JS 解析，而 JS 模式下对类型导入、解构导入的判断更保守 - 项目刚打开或刚装完依赖，索引尚未完成（看右下角是否还在显示
Indexing...） - 使用了动态 import（如
import(`./pages/${name}.vue`)），静态分析无法追踪路径，相关模块会被“安全保留”
怎么确保清理准确？先清缓存再操作
Optimize Imports 行为异常（该删的不删、不该删的删了），90% 是索引滞后或损坏。别跳过这步：
- 执行
File → Invalidate Caches and Restart… - 务必勾选：
Clear file system cache and Local History、Clear VCS Log caches and indexes、Delete embedded browser engine cache and cookies - 点击
Invalidate and Restart（不是Just Restart） - 等右下角索引完成（中小型 Vue 项目通常 2–5 分钟）
快捷键和批量处理实操要点
清理动作本身很简单，但方式不同效果差异大：
立即学习“前端免费学习笔记（深入）”；
- 当前文件：按
Ctrl + Alt + O（Win/Linux）或Cmd + Option + O（Mac），立刻删掉未使用的import，补上缺失的，按字母排序 - 整个项目：在
Project工具窗口中点击项目根目录 → 再按Ctrl + Alt + O；或右键根目录 →Optimize Imports - Vue 单文件组件中，
<script setup>里的命名导入（如import { ref, onMounted } from 'vue'）若只用了ref，onMounted会被删掉——这是正常行为，但要注意它不会删掉仅用于@ts-ignore或 JSDoc 的类型导入（比如/** @type {SomeType} */） - 想避免星号导入（
import * as utils from './utils'），进Settings → Editor → Code Style → JavaScript/TypeScript → Imports，把Class count to use import with '*'设为999
哪些 import 一定会漏掉？得手动补刀
Optimize Imports 不是静态类型检查器，以下情况它默认放过：
-
import type（TS 中的类型导入），即使完全没用，只要tsconfig.json里"importsNotUsedAsValues": "error"开着，就会保留 - 仅出现在 JSDoc 注释里的类型引用，例如
/** @param {MyService} svc */—— WebStorm 默认不扫描 JSDoc 做 import 依赖分析 - 通过字符串拼接或模板字面量导入的路径（
import(`./modules/${id}.ts`)），静态分析无法推断id值 - 某些第三方库的命名导入被间接用在泛型位置（如
const x: Array<foo> = []</foo>），可能逃过检测
这类 case 必须靠 Analyze → Run Inspection by Name，输入 unused import 全局扫描，逐个确认。
