vscode本身不提供自动整理代码结构功能，所谓“整理结构”需人工定义规则并依赖插件或脚本执行；盲目自动重排src目录会破坏import路径、类型引用和构建配置，引发编译错误或运行时崩溃。
VSCode 本身不提供“自动整理代码结构”的功能，所谓“整理结构”必须靠人定义规则、靠插件或脚本执行动作。盲目依赖插件一键重排目录，大概率破坏 import 路径、类型引用和构建配置，反而引发编译错误或运行时崩溃。
为什么不能用插件自动重排 src 目录结构
所谓“自动整理代码结构”，常被误解为把散乱的 utils、hooks、components 按名称归类到统一目录下。但真实项目中：
- 同一模块的逻辑可能横跨
src/features/login/下的api.ts、store.ts、LoginForm.vue—— 拆开就断掉组合式依赖 -
shared/utils被多个业务模块 import，挪动后所有相对路径（../../utils）或别名（@/utils）全部失效 - TypeScript 的
paths配置、Volar 的类型跳转、ESLint 的 import/no-unresolved 规则，全依赖现有路径语义 - 没有插件能理解你的业务边界，“按字母排序”或“按文件后缀归类”只会让协作更痛苦
Volar + ESLint + Prettier 是真正可落地的“结构维护”组合
与其幻想自动重排，不如用工具守住结构不退化。关键不是“整理”，而是“防乱”：
-
Volar在.vue文件中实时校验defineProps类型与import路径是否匹配，路径错一个字符就标红 -
ESLint启用import/no-cycle和import/no-relative-packages，阻止跨功能目录的随意引用 -
Prettier固定单文件内 script/template/style 的顺序、空行位置、属性换行风格，让“视觉结构”一致 - 在
.vscode/settings.json中配"editor.codeActionsOnSave": { "source.fixAll.eslint": true }，保存即修复
需要真·结构调整时，该怎么做
当确实要从“技术分层”转向“功能切片”（比如把 src/components/ 拆进 src/auth/、src/dashboard/），必须手动操作并验证：
- 先在
tsconfig.json的compilerOptions.paths中新增别名（如"@auth/*": ["src/auth/*"]），再批量替换 import - 用 VSCode 的全局搜索
import.*from.*components，逐条确认是否该迁入新模块，而非无差别替换 - 改完立刻运行
npm run build和npm run lint，任何Cannot find module或import/no-unused-path报错都要当场解决 - 修改
.code-workspace中的files.exclude，把旧路径加入排除（如"**/src/components/**"），防止误编辑残留文件
最易被忽略的一点：重构后的目录结构，必须同步更新 CI 流水线中的 lint/build 路径、测试覆盖率收集路径、Docker 构建上下文 —— 这些地方不会报红，但会静默导致质量门禁失效或镜像体积暴增。
