Vue / 系统课时
规划项目目录
规划项目目录
本课设计 Vue 3 管理后台项目的目录结构,通过合理划分页面、组件、路由、状态、接口和工具代码,让项目具备清晰的维护边界和持续扩展能力。
学习目标
- 理解前端工程目录划分的核心原则。
- 掌握 Vue 3 管理后台常用模块组织方式。
- 能够建立适合团队协作的代码依赖方向。
设计目录规划原则
大型管理后台不仅包含页面文件,还包含权限、接口、状态和公共能力。如果所有代码集中在同一目录,随着功能增加会导致定位困难和模块耦合。
合理目录需要满足三个原则:职责清晰、依赖单向、公共能力复用。推荐按照业务职责拆分,而不是按照文件类型简单堆叠。
建立基础目录结构
一个典型 Vue 3 管理后台可以采用以下结构:
text
src/
├── api/ # 接口请求定义
├── assets/ # 静态资源
├── components/ # 通用组件
├── layouts/ # 页面布局
├── router/ # 路由配置
├── stores/ # Pinia 状态
├── utils/ # 工具函数
├── views/ # 业务页面
├── App.vue
└── main.js这种结构中,views 负责业务页面,components 提供可复用组件,api 隔离后端通信逻辑,避免页面直接散落请求代码。
明确模块依赖方向
目录划分之后,还需要约束引用关系。推荐依赖方向:
text
views
↓
components
↓
utils
views
↓
api
↓
后端服务
router
↓
views页面可以调用公共模块,但工具层不应该反向依赖页面,否则会形成循环依赖。
初始化目录示例
可以使用命令快速创建基础目录。
bash
mkdir -p src/api src/components src/layouts src/router src/stores src/utils src/views预期输出
text
目录创建完成,无错误输出创建完成后,可以通过文件列表确认目录是否存在。
避免常见结构问题
一些早期项目容易出现以下问题:
- 所有页面组件都放入 components,导致业务组件和公共组件混杂。
- 接口请求直接写在页面中,后续难以统一处理错误和鉴权。
- 工具函数依赖业务模块,造成无法复用。
目录结构不是越复杂越好,而是应该随着业务增长保持可理解。
按自己的节奏,确认真正理解。