前言
各位读者朋友，最近有一个多礼拜没更文了，抱歉最近人感冒了，好多天感觉浑身没劲，直到最近两天身体才恢复过来。说实话最近天气实在太冷了，来深圳5年多还是第一次体验到这么冷的春天，连续下了4天的雨，每天温度低于6摄氏度以下。哪怕过年回湖南老家那段日子也不曾感到这么冷，今天湖南的同学群里发了湖南今天又下起了大雪的视频。可见最近南方的天气有多么冷，大家都注意防寒保暖吧。熬过这段异常寒冷的日子之后，相信就会迎来春暖花开的季节！
上次给大家安利了一个非常不错的开源项目ruoyi-vue-pro，是一个前后端分离项目，里面涉及的功能非常丰富。程序员不论是拿来学习还是做二次开发接私活都是非常不错的选择。既然项目非常好，那当然要搭建好调试环境，在本地跑起来看到效果后才好去研究项目源码和扩展新的功能。本文笔者就结合作者的部署文档带领大家如何搭建调试环境，在本地跑起来。
1 克隆代码
使用git克隆代码到本地磁盘目录
代码语言：javascript复制git clone https://github.com/YunaiV/ruoyi-vue-pro.git
然后使用IDEA执行File->Open打开克隆好的ruoyi-vue-pro项目
图 1 IDEA导入ruoyi-vue-pro项目后的项目结构
子项目 | 说明 |
|---|---|
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 模块 |
表 1 ruoyi-vue-pro项目中的子模块说明
然后执行File->Settings->Build,Execution,Deployment->Build Tools->Maven设置Maven本地仓库和settings.xml文件，点击OK后耐心等待IDEA从Maven中央仓库下载所需的全部jar包
图 2 ruoyi-vue-pro项目配置maven本地仓库
友情提示: IDEA 建议使用2021版本的旗舰版，不知道怎么激活的可以看看Intellij IDEA 2021.2.3 最新版免费激活教程(可激活至 2099 年，亲测有效)
2 初始化Mysql
项目中的数据，都存储到 MySQL 之中，所以需要在本地搭建一个 MySQL 服务，建议使用 5.7 版本。搭建好本地MySQL服务之后，启动Mysql服务，然后使用Navicat用root账户和登录密码连接Mysql服务
新建一个名字为 ruoyi_vue_pro 的数据库，然后执行 sql 目录下的 SQL，进行初始化。
图 3 使用Navicat连接Mysql服务后导入项目sql目录下的sql脚本
友情提示：注意，默认配置下，MySQL 需要启动在 3306 端口，且数据库名必须为 ruoyi_vue_pro
3 初始化 Redis
项目中的缓存，都存储到 Redis 之中，所以需要在本地搭建一个 Redis 服务。
一定要使用 5.0 以上的版本，项目使用 Redis Stream 作为消息队列。
windows系统 redis 5.0以上版本下载地址：https://github.com/tporadowski/redis/releases
图 4 下载windows系统下redis5.0以上版本msi镜像安装包
这里我们下载redis-x64-5.0.14.1.msi镜像安装包，然后打开msi镜像包安装到本地，默认会安装到C:Program FilesRedis目录下，笔者选择安装到了D:Program Filesredis5目录下
然后进入redis安装目录，在盘符上输入cmd命令回车进入控制台，然后输入启动redis服务的命令：
代码语言：javascript复制redis-server.exe redis.windows.conf
控制台出现如下日志信息表示redis启动成功
图 5 redis服务启动成功日志
4 启动后端项目【管理后台】
yudao-server 是后端项目的入口，提供管理后台、用户 APP 的 RESTful API 接口。
启动项目前需要依次将yudao-dependencies和yudao-framework两个模块中的jar包打包安装到本地Maven仓库
对yudao-dependencies和yudao-framework两个模块Maven依赖，在屏蔽掉Test后，执行Maven生命周期管理中的clean和install完成yudao-framework模块下的子模块全部打包安装到本地Maven仓库，控制台出现如下日志信息表示打包安装到本地Maven仓库成功
代码语言：javascript复制[INFO] --- maven-install-plugin:2.4:install (default-install) @ yudao-spring-boot-starter-biz-data-permission ---
[INFO] Installing D:githubruoyi-vue-proyudao-frameworkyudao-spring-boot-starter-biz-data-permissiontargetyudao-spring-boot-starter-biz-data-permission-1.5.0-snapshot.jar to D:mavenRepository.m2cniocoderbootyudao-spring-boot-starter-biz-data-permission1.5.0-snapshotyudao-spring-boot-starter-biz-data-permission-1.5.0-snapshot.jar
[INFO] Installing D:githubruoyi-vue-proyudao-frameworkyudao-spring-boot-starter-biz-data-permissionpom.xml to D:mavenRepository.m2cniocoderbootyudao-spring-boot-starter-biz-data-permission1.5.0-snapshotyudao-spring-boot-starter-biz-data-permission-1.5.0-snapshot.pom
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary for yudao-framework 1.5.0-snapshot:
[INFO]
[INFO] yudao-framework .................................... SUCCESS [ 0.527 s]
[INFO] yudao-common ....................................... SUCCESS [ 8.085 s]
[INFO] yudao-spring-boot-starter-web ...................... SUCCESS [ 6.906 s]
[INFO] yudao-spring-boot-starter-mybatis .................. SUCCESS [ 4.253 s]
[INFO] yudao-spring-boot-starter-redis .................... SUCCESS [ 3.104 s]
[INFO] yudao-spring-boot-starter-security ................. SUCCESS [ 3.510 s]
[INFO] yudao-spring-boot-starter-monitor .................. SUCCESS [ 2.265 s]
[INFO] yudao-spring-boot-starter-protection ............... SUCCESS [ 4.330 s]
[INFO] yudao-spring-boot-starter-config ................... SUCCESS [ 3.483 s]
[INFO] yudao-spring-boot-starter-job ...................... SUCCESS [ 2.872 s]
[INFO] yudao-spring-boot-starter-mq ....................... SUCCESS [ 2.903 s]
[INFO] yudao-spring-boot-starter-biz-dict ................. SUCCESS [ 1.772 s]
[INFO] yudao-spring-boot-starter-excel .................... SUCCESS [ 2.426 s]
[INFO] yudao-spring-boot-starter-test ..................... SUCCESS [ 2.589 s]
[INFO] yudao-spring-boot-starter-extension ................ SUCCESS [ 4.159 s]
[INFO] yudao-spring-boot-starter-biz-operatelog ........... SUCCESS [ 3.273 s]
[INFO] yudao-spring-boot-starter-biz-sms .................. SUCCESS [ 5.545 s]
[INFO] yudao-spring-boot-starter-activiti ................. SUCCESS [ 5.332 s]
[INFO] yudao-spring-boot-starter-biz-pay .................. SUCCESS [ 6.880 s]
[INFO] yudao-spring-boot-starter-biz-weixin ............... SUCCESS [ 0.301 s]
[INFO] yudao-spring-boot-starter-biz-social ............... SUCCESS [ 2.842 s]
[INFO] yudao-spring-boot-starter-biz-tenant ............... SUCCESS [ 4.833 s]
[INFO] yudao-spring-boot-starter-biz-data-permission ...... SUCCESS [ 6.426 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 01:29 min
[INFO] Finished at: 2022-02-22T22:48:12 08:00
[INFO] ------------------------------------------------------------------------
然后修改yudao-server模块项目中src/main/resources目录下的应用配置文件application-local.yml,将Master和Slav两个Mysql数据库名改为ruoyi_vue_pro，并把root用户的登录密码改为自己本地Mysql root用户的认证密码，如下所示：
图 6 修改application-local.yml文件中的Mysql连接信息
最后以Debug模式启动yudao-server模块项目中启动类YudaoServerApplication中的main方法，控制台中没有报错而导致服务中止则代表后台服务启动成功
图 7 yudao-server服务启动成功日志
启动完成后，使用浏览器访问 http://127.0.0.1:48080 地址，返回如下 JSON 字符串，说明成功。
代码语言：javascript复制{
"code": 401,
"data": null,
"msg": "账号未登录"
}
注意: 默认配置下，后端项目启动在 48080 端口。
5. 启动前端项目【管理后台】
在 yudao-admin-ui 目录下，执行如下命令，进行启动：
代码语言：javascript复制# 进入项目目录
cd yudao-admin-ui
# 安装依赖
# 建议不要直接使用 cnpm 安装依赖，会有各种诡异的 bug。可以通过如下操作解决 npm 下载速度慢的问题
npm install --registry=https://registry.npm.taobao.org
# 启动服务
npm run dev
App running at:
- Local: http://localhost:80/
- Network: http://192.168.1.235:80/
启动完成后，在谷歌浏览器网址一栏中输入 http://localhost:80 后回车，可以看到前端界面。
图 8 系统登录界面
输入验证码，并勾选记住密码点击【登录】按钮，登录成功后进入系统首页。
图 9 系统首页
到这里代表ruoyi-vue-pro项目在本地成功跑起来了！
---END---
