大型项目中,Vue项目怎么划分结构和划分组件比较合理呢?
参考答案
划分原则
按「业务域 + 复用层级 + 变更频率」划分,而不是按文件类型。
推荐目录结构
src/
├── api/ # 接口定义,按业务域拆文件(user.js / order.js),统一错误处理
├── assets/ # 静态资源(图片、字体、全局样式)
├── components/ # 通用组件(跨页面复用)
│ ├── base/ # 基础组件(Button、Input 包装)
│ └── business/ # 业务通用组件(UserSelect、OrderTable)
├── composables/ # 组合式函数(useRequest、usePermission、usePagination)
├── directives/ # 全局指令
├── layouts/ # 布局(BasicLayout、BlankLayout)
├── router/ # 路由表、守卫、动态路由
├── stores/ # Pinia,按域拆(user/cart/order)
├── styles/ # 变量、重置、混入
├── utils/ # 纯函数工具(format、validate、storage)
├── views/ # 页面(按业务域分子目录)
│ ├── user/
│ │ ├── index.vue
│ │ ├── components/ # 仅本模块用的组件
│ │ └── composables/
├── App.vue
└── main.js
组件划分(粒度)
- 容器组件 vs 展示组件:容器负责数据与逻辑(请求、状态),展示组件只接收 props 渲染(易复用、易测);
- 单一职责:一个组件只做一件事;组件超过 200~300 行或承担 3 种以上职责时考虑拆分;
- 按「变化频率」拆:频繁变化的与稳定的分开,缩小重渲染范围;
- 按「复用范围」分层:页面私有组件放页面目录,跨页面通用放
components/,基础 UI 放components/base/; - 避免过度抽象:只有出现 2~3 处重复时才抽公共组件,过早抽象比重复更难维护;
- props 契约清晰:props 少而明确,复杂配置用对象 + 默认值;事件语义化(
update:xxx、submit); - 插槽优先于 props 堆砌:内容类扩展用 slot,配置类用 props。
其他工程约定
- 命名:组件 PascalCase,组合式函数
useXxx,storeuseXxxStore,文件与组件同名; - 样式:SFC scoped,全局样式集中管理,避免深层选择器;
- 类型:TS 定义 API 响应与 props;
- 路径别名
@/; - 大模块用「业务域分包」,便于后续拆微前端。