开发指南
萌新必读

快速启动（前端项目）

目标：将项目 ruoyi-vue-pro (opens new window) 的前端项目运行起来 ??

整个过程非常简单，预计 5 分钟就可以完成，取决于大家的网速。

↓↓↓ 技术交流群，一起苦练技术基本功，每日精进 30 公里！↓↓↓

交流群

友情提示：可能胖友本地没有安装 Node.js 的环境，导致报错。可以参考如下文档安装：

Windows 安装 Node.js 指南：http://www.iocoder.cn/NodeJS/windows-install (opens new window)

Mac 安装 Node.js 指南：http://www.iocoder.cn/NodeJS/mac-install (opens new window)

# ?? 相关视频教程

# 1. 管理后台

项目的管理后台有 4 个版本：

yudao-ui-admin-vue3 (opens new window)：基于 Vue3 + element-plus
yudao-ui-admin-vben (opens new window)：基于 Vue3 + vben(ant-design-vue)
yudao-ui-admin-vue2 (opens new window)：基于 Vue2 + element-ui
yudao-ui-admin-uniapp (opens new window)：基于 Vue2 + uni-app

# 1.1 Vue3 + element-plus 版本

yudao-ui-admin-vue3 (opens new window) 是前端 Vue3 管理后台项目。

① 克隆 https://github.com/yudaocode/yudao-ui-admin-vue3.git (opens new window) 项目，并 Star 关注下该项目。

② 在根目录执行如下命令，进行启动：

# 安装 pnpm，提升依赖的安装速度
npm config set registry https://registry.npmjs.org
npm install -g pnpm
# 安装依赖
pnpm install

# 启动服务
npm run dev

③ 启动完成后，浏览器会自动打开 http://localhost:80 (opens new window) 地址，可以看到前端界面。

前端界面

友情提示：Vue3 使用 Vite 构建，所以它存在如下的情况，都是正常的：

项目启动很快，浏览器打开需要等待 1 分钟左右，请保持耐心。
点击菜单，感觉会有一点卡顿，因为 Vite 采用懒加载机制。不用担心，最终部署到生产环境，就不存在这个问题了。

详细说明，可见《为什么有人说 Vite 快，有人却说 Vite 慢？》 (opens new window) 文章。

疑问：我是前端工程师，不想启动后端项目，怎么办？

可以将上述的 npm run dev 命令，替代成 npm run dev-server 命令。

远程演示环境的后端服务，只允许 GET 请求，不允许 POST、PUT、DELETE 等请求。

# 1.2 Vue3 + vben(ant-design-vue) 版本

yudao-ui-admin-vue3 (opens new window) 是前端 Vue3 + vben(ant-design-vue) 管理后台项目。

① 克隆 https://github.com/yudaocode/yudao-ui-admin-vben.git (opens new window) 项目，并 Star 关注下该项目。

② 在根目录执行如下命令，进行启动：

# 安装 pnpm，提升依赖的安装速度
npm config set registry https://registry.npmjs.org
npm install -g pnpm
# 安装依赖
pnpm install

# 启动服务
npm run dev

③ 启动完成后，浏览器会自动打开 http://localhost:80 (opens new window) 地址，可以看到前端界面。

前端界面

疑问：我是前端工程师，不想启动后端项目，怎么办？

可以将上述的 npm run dev 命令，替代成 npm run front 命令。

远程演示环境的后端服务，只允许 GET 请求，不允许 POST、PUT、DELETE 等请求。

# 1.3 Vue2 + element-ui 版本

yudao-ui-admin-vue2 (opens new window) 是前端 Vue2 管理后台项目。

① 克隆 https://github.com/yudaocode/yudao-ui-admin-vue2.git (opens new window) 项目，并 Star 关注下该项目。

② 在根目录执行如下命令，进行启动：

# 安装 Yarn，提升依赖的安装速度
npm install --global yarn
# 安装依赖
yarn install

# 启动服务
npm run local

启动前端项目

② 启动完成后，浏览器会自动打开 http://localhost:1024 (opens new window) 地址，可以看到前端界面。

前端界面

疑问：我是前端工程师，不想启动后端项目，怎么办？

可以将上述的 npm run local 命令，替代成 npm run front 命令。

远程演示环境的后端服务，只允许 GET 请求，不允许 POST、PUT、DELETE 等请求。

# 1.4 Vue2 + uni-app 版本

yudao-ui-admin-uniapp (opens new window) 是前端 uni-app 管理后台项目。

① 克隆 https://github.com/yudaocode/yudao-ui-admin-uniapp.git (opens new window) 项目，并 Star 关注下该项目。

② 下载 HBuilder (opens new window) 工具，并进行安装。

③ 点击 HBuilder 的 [文件 -> 导入 -> 从本地项目导入...] 菜单，选择项目的 yudao-ui-admin-uniapp 目录。

④ 执行如下命令，安装 npm 依赖：

# 安装 npm 依赖
npm i

⑤ 点击 HBuilder 的 [运行 -> 运行到内置浏览器] 菜单，使用 H5 的方式运行。成功后，界面如下图所示：

前端界面

友情提示：登录时，滑块验证码，在内存浏览器可能存在兼容性的问题，此时使用 Chrome 浏览器，并使用“开发者工具”，设置为 iPhone 12 Pro 模式！

疑问：我是前端工程师，不想启动后端项目，怎么办？

修改 config.js 配置文件的 baseUrl 后端服务的地址为 'http://api-dashboard.yudao.iocoder.cn。如下图所示：

修改配置文件的后端服务的地址

远程演示环境的后端服务，只允许 GET 请求，不允许 POST、PUT、DELETE 等请求。

# 2. uni-app 商城移动端

yudao-mall-uniapp (opens new window) 是前端 uni-app 商城移动端项目。

前置任务：

需要参考《商城手册 —— 功能开启》文档，将商城的后端启动。

① 克隆 https://github.com/yudaocode/yudao-mall-uniapp (opens new window) 项目，并 Star 关注下该项目。

② 下载 HBuilder (opens new window) 工具，并进行安装。

③ 点击 HBuilder 的 [文件 -> 导入 -> 从本地项目导入...] 菜单，选择克隆的 yudao-mall-uniapp 目录

④ 执行如下命令，安装 npm 依赖：

# 安装 npm 依赖
npm i

⑤ 点击 HBuilder 的 [运行 -> 运行到浏览器 -> Chrome] 菜单，使用 H5 的方式运行。成功后，界面如下图所示：

前端界面

疑问：我是前端工程师，不想启动后端项目，怎么办？

搜索 http://127.0.0.1:48080 关键字，修改后端服务的地址为 'http://api-dashboard.yudao.iocoder.cn/。如下图所示：

修改配置文件的后端服务的地址

# 666. 参与项目

如果你想参与到前端项目的开发，可以微信 wangwenbin-server 噢。

近期，重点开发 Vue3 管理后台、uniapp 商城，欢迎大家参与进来。

← 快速启动（后端项目）接口文档→