快速开始
本页只保留本地启动所需步骤。环境配置、接口联调、部署和排障请按“下一步”进入对应页面。
环境要求
| 环境 | 要求 | 说明 |
|---|---|---|
| Node.js | ^20.19.0 或 >=22.12.0 | 推荐 LTS 版本 |
| pnpm | >= 8.0.0 | 项目使用 pnpm 管理依赖 |
获取项目
bash
git clone https://gitee.com/youlaiorg/vue3-element-admin.git
cd vue3-element-adminbash
git clone https://github.com/youlaitech/vue3-element-admin.git
cd vue3-element-admin安装依赖
bash
corepack enable
pnpm install国内网络较慢时，可先切换镜像源：
bash
pnpm config set registry https://registry.npmmirror.com启动项目
bash
pnpm run dev启动成功后访问终端输出的本地地址，默认通常是 http://localhost:3000。
构建预览
bash
pnpm run build
pnpm run preview构建产物输出到 dist/，可部署到 Nginx、静态托管平台或对象存储。
下一步
| 你要做什么 | 推荐入口 |
|---|---|
| 看懂项目目录 | 项目结构 |
| 配置后端地址 | 环境配置 |
| 理解请求封装 | 接口请求 |
| 理解路由和权限 | 路由和菜单 / 权限控制 |
| 快速开发业务页面 | CURD 快速开发 |
| 打包部署到服务器 | 构建和部署 |
| 安装或启动失败 | FAQ |