根本原因是webstorm的refactor→move仅分析ast可解析的静态模块引用，不处理动态拼接、别名未索引、类型导入、运行时弱引用及正则/json等非代码路径；需勾选search for text occurrences并同步配置tsconfig.json paths和构建工具别名。
移动文件后 import 路径没更新，根本原因不是操作遗漏，而是 WebStorm 默认不扫描路径字符串
WebStorm 的 Refactor → Move（F6）只处理 AST 可解析的模块引用，比如 import { foo } from './old/path' 中的 './old/path' 字符串——但它不会分析动态拼接、别名、或未索引上下文中的路径。你拖动一个文件到新目录，看到 import 还指着旧位置，不是 IDE 偷懒，是它压根没把那段字符串当“可重构目标”。
常见错误现象包括：import('@/pages/UserList.vue') 移动后仍报错；require('./' + name) 里的 name 变量值变了但路径没变；node_modules 里第三方包的内部引用完全不动。
- 必须在项目视图（Project tool window）中右键文件或选中后按
F6，不能在编辑器打开状态下按F6（此时可能触发元素重命名） - 确保文件状态栏显示
Vue、TypeScript或JavaScript，而不是Plain Text；否则重构退化为纯文本替换 - 移动对话框中务必勾选
Search for text occurrences—— 这是唯一控制import、require、fetch字符串路径是否被扫描的开关 - 如果用了
tsconfig.json的paths别名（如@/components/*），需提前在Settings > Languages & Frameworks > JavaScript > Webpack中配置别名映射，否则别名路径不会被识别为模块引用
Vue 组件移动后模板标签和路由配置不会自动更新
Vue SFC 文件移动后，<user-list></user-list> 这类自定义标签、router.addRoute({ component: UserList })、app.component('user-list', UserList) 都不会被 Move 操作覆盖。因为这些是运行时弱引用，WebStorm 的静态分析无法推断其与文件路径的绑定关系。
典型漏改点：
- 所有
<user-list></user-list>、<userlist></userlist>、<user-list></user-list>标签（注意大小写和 kebab-case 与 PascalCase 差异） -
router/index.ts或src/router/routes.ts中的component: () => import('./old/UserList.vue') - 全局注册语句如
app.component('user-list', UserList)中的字符串参数'user-list' - 如果组件被
defineAsyncComponent包裹，其工厂函数里的路径也要手动改
移动 TypeScript 类或函数时，类型导入和泛型引用容易被忽略
移动一个 utils.ts 里的 export function formatDate()，WebStorm 会更新 import { formatDate } from './utils'，但不会动 import type { FormatOptions } from './utils' —— 因为类型导入默认不参与重构扫描，除非你主动勾选 Search for text occurrences 并确认它包含 import type 行。
更隐蔽的问题出现在泛型或类型参数中：
-
const result = useQuery<userdata>(...)</userdata>中的UserData如果来自被移动的文件，且声明为interface UserData，它会被更新；但如果写成type UserData = { ... }且该类型在declare module或.d.ts中，就不会被追踪 -
defineProps()里的Item如果来自移动文件，且未被显式导入（靠自动类型推导），则不会更新 -
import('./module').then(m => m.SomeClass)这种动态 import 的返回类型不会被重构识别
验证路径是否真正生效，最可靠的方式是 Ctrl+B 跳转
改完别急着跑，直接在任意 import 行按 Ctrl+B（Windows/Linux）或 Cmd+B（macOS）。如果光标跳转到新文件，说明路径已更新；跳不到，就说明某处漏了。
特别要注意的是：某些路径看似更新了，但实际指向错误位置，比如从 src/pages/UserList.vue 移到 src/modules/user/UserList.vue 后，import('@/modules/user/UserList.vue') 能跳转，但 @/modules/user 这个别名本身没在 tsconfig.json 中声明，运行时仍 404。所以重构后必须检查别名配置是否同步、构建工具（Vite/Webpack）是否能解析新路径。
动态路径（import(`./${page}.vue`)）、JSON 配置（"component": "./old.vue"）、正则字面量（/\.old\.vue$/）全都不在 WebStorm 重构范围内，只能靠 Find → Replace in Path 手动扫，且替换前务必确认上下文，避免误改注释或字符串内容。
