create-vue3-admin-template

使用 Vue3 Admin Template 创建可直接开发、测试和部署的 Vue 3 管理后台项目。

npm create vue3-admin-template@latest my-admin
cd my-admin
corepack pnpm install --frozen-lockfile
pnpm dev

默认生成企业标准版，也可以选择精简版、完整版或自定义业务能力：

# 精简版：后台核心、RBAC、国际化、环境校验和默认 Mock 认证
npm create vue3-admin-template@latest my-admin -- --preset minimal

# 企业标准版：精简版 + OpenAPI + PageForm + Docker（默认）
npm create vue3-admin-template@latest my-admin -- --preset standard

# 自定义能力
npm create vue3-admin-template@latest my-admin -- \
  --preset custom \
  --features openapi,page-form,docker

完整版额外包含 TableComponent。生产使用 Handsontable 前必须取得有效商业许可证：

npm create vue3-admin-template@latest my-admin -- \
  --preset full \
  --accept-handsontable-license

创建时自动安装依赖：

npm create vue3-admin-template@latest my-admin -- --install

自动化环境可以使用 --yes 接受企业标准版推荐配置并安装依赖。

认证模式和品牌配置不属于业务能力开关，可以独立指定：

npm create vue3-admin-template@latest my-admin -- \
  --auth api \
  --api-base-url /gateway \
  --title "Operations Center" \
  --company "Example Corp" \
  --theme-color "#123ABC" \
  --locale zh \
  --logo ./company-logo.svg

api 模式会移除认证 Mock；mock 模式开箱即可登录。生成项目会使用 Zod 在启动和构建阶段校验环境变量。

发布前验证

脚手架维护仓库会验证 2 种认证模式与 4 项可选能力形成的全部 32 种组合。每种组合都必须完成冻结锁文件安装、类型检查、生产构建并启动开发服务器；Mock 模式还会验证登录和动态路由接口，CI 会实际构建单独 Docker 能力的容器镜像：

pnpm --dir packages/create-vue3-admin-template test:matrix

npm publish 前会自动执行真实 tarball 冒烟和上述能力矩阵；这些维护测试不会进入生成的业务项目。

要求 Node.js ^20.19.0 || >=22.13.0。目标目录必须为空，CLI 不会覆盖已有文件。

源码与问题反馈：https://gitee.com/he-cli-template/vue3-admin-template

本软件为专有软件并标记为 UNLICENSED，未经版权所有者书面授权不得使用、复制、修改或分发。