ruoyi-vue-pro 项目搭建

出处 http://www.iocoder.cn/Yudao/build-debugger-environment/ 「芋道源码」欢迎转载，保留摘要，谢谢！

1. 克隆代码
2. 初始化 MySQL
3. 初始化 Redis
4. 启动后端项目
5. 启动前端项目
6. 彩蛋
   本文，我们来搭建 https://github.com/YunaiV/ruoyi-vue-pro 的调试环境。

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

1. 克隆代码
   使用 IDEA 克隆代码，地址是 https://github.com/YunaiV/ruoyi-vue-pro。

克隆完成后，耐心等待 Maven 下载完相关的依赖。

项目一览

项目 说明
yudao-dependencies Maven 依赖版本管理
yudao-framework Java 框架拓展
yudao-server 管理后台 + 用户 APP 的服务端
yudao-admin-ui 管理后台的 UI 界面
yudao-user-ui 用户 APP 的 UI 界面
yudao-module-system 系统功能的 Module 模块
yudao-module-member 会员中心的 Module 模块
yudao-module-infra 基础设施的 Module 模块
yudao-module-tool 研发工具的 Module 模块
yudao-module-bpm 工作流程的 Module 模块
yudao-module-pay 支付系统的 Module 模块
使用的 SpringBoot 版本是最新的 2.5.9，所以需要下载一段时间。趁着这个时间，胖友可以给项目添加一个 Star，支持下艿艿。

2. 初始化 MySQL
   项目中的数据，都存储到 MySQL 之中，所以需要在本地搭建一个 MySQL 服务，建议使用 5.7 版本。

新建一个名字为 ruoyi-vue-pro 数据库，然后执行 sql 目录下的 SQL，进行初始化。

MySQL 数据库

友情提示：注意，默认配置下，MySQL 需要启动在 3306 端口，且数据库名必须为 ruoyi-vue-pro。

3. 初始化 Redis
   项目中的缓存，都存储到 Redis 之中，所以需要在本地搭建一个 Redis 服务。

一定要使用 5.0 以上的版本，项目使用 Redis Stream 作为消息队列。

友情提示：注意，默认配置下，Redis 需要启动在 6379 端口。

不会安装的胖友，可以选择阅读下文，良心的艿艿。

Windows 安装 Redis 指南：http://www.iocoder.cn/Redis/windows-install
Mac 安装 Redis 指南：http://www.iocoder.cn/Redis/mac-install
4. 启动后端项目【管理后台】
yudao-server 是后端项目，提供管理后台、用户 APP 的 RESTful API 接口。通过执行 YudaoServerApplication 类，进行启动。

启动后端项目

启动完成后，使用浏览器访问 http://127.0.0.1:48080 地址，返回如下 JSON 字符串，说明成功。

{
“code”: 401,
“data”: null,
“msg”: “账号未登录”
}
友情提示：注意，默认配置下，后端项目启动在 48080 端口。

5. 启动前端项目【管理后台】
   yudao-admin-ui 是管理后台的前端项目。一共有两种方式：

① 内嵌模式：无需配置前端开发环境，可以进行快速体验。每次发布版本时，艿艿会将 yudao-admin-ui 编译成静态资源，放置到 yudao-server 中，使用 Spring Boot 转发静态资源。内嵌模式

② 完整模式：需要配置前端开发环境，适合进行前端功能的开发。

胖友可以根据自己的情况，选择合适的方式。如果你是一个后端开发，对前端了解相对较少，建议先采用方式一，能够快速的 run 起来！

5.1 方式一：内嵌模式
使用浏览器，直接访问 http://127.0.0.1:48080/admin-ui 地址，可以看到前端界面。

前端界面

5.2 方式二：完整模型
在 yudao-admin-ui 目录下，执行如下命令，进行启动：

#进入项目目录
cd yudao-admin-ui

#安装依赖
#建议不要直接使用 cnpm 安装依赖，会有各种诡异的 bug。可以通过如下操作解决 npm 下载速度慢的问题
npm install --registry=https://registry.npm.taobao.org

#启动服务
npm run dev

启动前端项目

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

Windows 安装 Node.js 指南：http://www.iocoder.cn/NodeJS/windows-install
Mac 安装 Node.js 指南：http://www.iocoder.cn/NodeJS/mac-install
注意，Node 请使用 14 的版本！！！例如说，艿艿本地的是 Now using node v14.15.3 (npm v6.14.9) 版本。

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

前端界面

6. 启动前端项目【小程序】
   TODO 正在开发中

7. 彩蛋
   至此，我们已经完成了 https://github.com/YunaiV/ruoyi-vue-pro 的调试环境。

胖友可以根据自己的兴趣，阅读相关源码。

后面，艿艿会花大量的时间，继续优化这个项目。同时，输出与项目匹配的技术博客，方便胖友更好的学习与理解。

嘿嘿嘿，记得一定要给 https://github.com/YunaiV/ruoyi-vue-pro 一个 star，这对艿艿真的很重要。