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,导致业务组件和公共组件混杂。
  • 接口请求直接写在页面中,后续难以统一处理错误和鉴权。
  • 工具函数依赖业务模块,造成无法复用。

目录结构不是越复杂越好,而是应该随着业务增长保持可理解。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

规划项目目录

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通