盲目用插件重排src目录必出问题，vscode无内置自动整理功能，插件仅机械搬运文件，会破坏import路径、tsconfig别名、volar类型跳转和eslint校验；真正有效的是volar+eslint+prettier组合守住结构不退化。
盲目用插件重排 src 目录必出问题
VSCode 没有内置“自动整理代码结构”功能，所有声称能“一键归类 components/utils/hooks”的插件，本质都是按文件名或后缀做机械搬运。这会直接破坏：import 路径、tsconfig.json 中的 paths 别名、Volar 的类型跳转、ESLint 的 import/no-unresolved 校验。
典型错误现象：
- 迁移后
import { useAuth } from '@/hooks'报红，实际文件已挪到src/features/auth/hooks -
npm run build失败，提示Cannot find module '@utils/request' - Volar 在
.vue文件里点不进defineProps类型定义
根本原因：插件无法理解你的业务边界。它不知道 src/utils/request.ts 是被 src/features/chat/ 和 src/features/video/ 共享的核心模块，强行挪走就等于切断依赖链。
真正有效的结构防乱三件套
不是靠插件“整理”，而是靠工具“守住”现有结构不退化。关键配置全在 .vscode/settings.json 里：
- 启用
Volar：实时校验defineProps类型与import路径是否匹配，路径错一个字符就标红 - 配 ESLint 规则：
import/no-cycle阻止跨功能目录循环引用，import/no-relative-packages禁止写../../../utils这种脆弱路径 - 加 Prettier：固定单文件内
<script></script>/<template></template>/<style></style>顺序、空行位置、属性换行风格，让“视觉结构”一致 - 开启保存即修复：
"editor.codeActionsOnSave": { "source.fixAll.eslint": true }
这些组合不改变目录，但能让每次保存都自动对齐规范——比事后补救强十倍。
必须手动重构时的最小安全操作流
当真要从技术分层（src/components）转向功能切片（src/auth/），必须人工主导，每步验证：
- 先在
tsconfig.json的compilerOptions.paths中新增别名，比如"@auth/*": ["src/auth/*"]，再批量替换import语句 - 用 VSCode 全局搜索
import.*from.*components，逐条确认是否该迁入新模块——不能无差别替换，有些Button是全局组件，有些是auth/LoginButton - 改完立刻运行
npm run build和npm run lint；任何Cannot find module或import/no-unused-path报错必须当场解决 - 把旧路径加入
.code-workspace的files.exclude，比如"**/src/components/**"，防止误编辑残留文件
最易被忽略的一点：重构后的目录结构，必须同步更新 CI 流水线中的 lint/build 路径、测试覆盖率收集路径、Docker 构建上下文 —— 否则上线前最后一刻才发现构建失败。
