---

Vue-Bag-Admin 不只是一个后台工程模板，也是一套正在拆包发布的插件化后台生态。它把布局、权限、路由、请求、Schema UI 和插件引导收敛到统一主包中，让业务项目可以先轻量启动，再按需接入独立插件。

你可以直接用脚手架创建一个新的后台宿主，也可以在当前 Monorepo 中开发框架、插件、文档站和参考后端。

为什么选择

适合场景

快速开始

创建新的后台项目

npx create-vue-bag-admin my-admin
cd my-admin
pnpm install
pnpm dev

脚手架当前使用 templates/basic 生成最小宿主模板，默认只安装 vue-bag-admin。当项目需要商城、系统设置等官方业务能力时，再按需安装对应的 @bag/plugin-* 插件即可。

开发当前 Monorepo

pnpm install
pnpm --filter admin dev

如果需要同时运行参考后端，请先准备 MySQL 数据库 vue_bag_admin，再启动 Strapi：

cd apps/strapi
cp .env.example .env
pnpm dev

环境要求

仓库中的 .nvmrc / .nvmdrc 使用完整版本号 24.4.1，避免部分版本管理工具无法解析 24 简写。

项目结构

Vue-Bag-Admin
├── apps
│   ├── admin                 # 前端宿主应用 (Vue3)
│   ├── docs                  # VitePress 官方文档
│   └── strapi                # 参考后端服务 (Strapi 5)
├── packages
│   ├── core                  # 协议层：插件、路由 meta、Schema 等
│   ├── host-vue              # 宿主层：布局、权限、路由、插件引导
│   ├── request               # 请求能力层
│   ├── ui                    # Schema 驱动的 UI 组件层
│   ├── vue-bag-admin         # 面向业务项目的统一主包
│   ├── create-vue-bag-admin  # 初始化脚手架
│   └── plugin-*              # 官方业务插件与示例插件
├── pnpm-workspace.yaml       # Monorepo 配置
└── package.json

包生态

常用命令

延伸阅读

• 快速开始
• 插件开发指南
• 宿主层说明

交流

如果你想交流使用体验、插件设计，或者一起补齐项目的能力边界，可以访问联系页面。