快速启动（后端项目）

目标：使用 IDEA 工具，将项目 ruoyi-vue-pro (opens new window) 的后端项目运行起来 ??

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

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

# ?? 相关视频教程

• 从零开始 02：在 Windows 环境下，如何运行前后端项目？ (opens new window)
• 从零开始 03：在 MacOS 环境下，如何运行前后端项目？ (opens new window)

# 1. 克隆代码

使用 IDEA (opens new window) 克隆 https://github.com/YunaiV/ruoyi-vue-pro (opens new window) 仓库的最新代码，并给该仓库一个 Star (opens new window)。

注意：不建议使用 Eclipse，因为它没有支持 Lombok 和 Mapstruct 插件。

克隆完成后，耐心等待 Maven 下载完相关的依赖。一定要注意：

① 默认情况下，使用 master 分支，它对应 JDK 8 + Spring Boot 2.7.18 版本。

② 如果你想体验 JDK 21 + Spring Boot 3.X 版本，需要切换到 master-jdk17 分支。

友情提示：项目的每个模块的作用，可见 《开发指南 —— 项目结构》 文档。

使用的 Spring Boot 版本较新，所以需要下载一段时间。趁着这个时间，胖友可以给项目添加一个 Star (opens new window)，支持下艿艿。

# 2. Apifox 接口工具

点击 Apifox (opens new window) 首页，下载对应的 Apifox 桌面版。如下图所示：

解压后，双击进行安装即可。黑色界面，非常酷炫。

# 3. 初始化 MySQL

项目使用 MySQL 存储数据，所以需要启动一个 MySQL 服务，建议使用 5.7 版本。

① 创建一个名字为 ruoyi-vue-pro 数据库，【只要】 执行对应数据库类型的 sql (opens new window) 目录下的 ruoyi-vue-pro.sql SQL 文件，进行初始化。

② 默认配置下，MySQL 需要启动在 3306 端口，并且账号是 root，密码是 123456。如果不一致，需要修改 application-local.yaml 配置文件。

如果是 MySQL 数据库，不需要看 ③、④ 两点！！！

③ 【如果是 PostgreSQL、Oracle、SQL Server 数据库】，修改 yudao-spring-boot-starter-mybatis 模块的 pom.xml 文件，将对应的 JDBC Driver 的 optional 移除。如下图所示：

注意，需要使用 IDEA 刷新下 Maven 的依赖。

④ 【如果是 DM 达梦数据库】建议先使用 MySQL 跑通，然后再阅读 《达梦数据库专属》 文档。

# 4. 初始化 Redis

项目使用 Redis 缓存数据，所以需要启动一个 Redis 服务。

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

• Windows 安装 Redis 指南：http://www.iocoder.cn/Redis/windows-install (opens new window)
• Mac 安装 Redis 指南：http://www.iocoder.cn/Redis/mac-install (opens new window)

默认配置下，Redis 启动在 6379 端口，不设置账号密码。如果不一致，需要修改 application-local.yaml 配置文件。

# 5. 启动后端项目

yudao-server (opens new window) 是后端项目，提供管理后台、用户 APP 的 RESTful API 接口。

# 5.1 编译项目

第一步，使用 IDEA 打开 Terminal 终端，在 根目录 下直接执行 mvn clean install package '-Dmaven.test.skip=true' 命令，将项目进行初始化的打包，预计需要 1 分钟左右。成功后，控制台日志如下：

[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 01:12 min
[INFO] Finished at: 2022-02-12T09:52:38+08:00
[INFO] Final Memory: 250M/2256M
[INFO] ------------------------------------------------------------------------

# 5.2 启动项目

第二步，执行 YudaoServerApplication (opens new window) 类，进行启动。

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

友情提示：注意，默认配置下，后端项目启动在 48080 端口。

{
    "code": 401,
    "data": null,
    "msg": "账号未登录"
}

如果报 “Command line is too long” 错误，参考 《Intellij IDEA 运行时报 Command line is too long 解决方法 》 (opens new window) 文章解决，或者直接点击 YudaoServerApplication 蓝字部分！

# 5.3 启动其它模块

考虑到启动速度，默认值启动 system 系统服务，infra 基础设施两个模块。如果你需要启动其它模块，可以参考下面的文档：

• 《工作流手册 —— 工作流》
• 《公众号手册 —— 功能开启》
• 《支付手册 —— 功能开启》
• 《大屏手册 —— 报表设计器》
• 《商城手册 —— 功能开启》

# 6. 启动前端项目【简易】

在 yudao-ui-static (opens new window) 项目中，提前编译好了前端项目的静态资源，可以直接体验和使用。操作步骤如下：

① 克隆 https://gitee.com/yudaocode/yudao-ui-static (opens new window) 项目，运行 UiConfiguration 类，进行启动。

② 访问 http://127.0.0.1:2048/admin-ui-vue2/ (opens new window) 地址，可以看到 Vue2 管理后台。

② 访问 http://127.0.0.1:2048/admin-ui-vue3/ (opens new window) 地址，可以看到 Vue3 + element-plus 管理后台。

③ 访问 http://127.0.0.1:2048/admin-ui-vben/ (opens new window) 地址，可以看到 Vue3 + vben(ant-design-vue) 管理后台。

# 7. 启动前端项目【完整】

参考 《快速启动（前端项目）》 文档

# 666. 彩蛋

至此，我们已经完成了项目 ruoyi-vue-pro (opens new window) 的启动。

胖友可以根据自己的兴趣，阅读相关源码。如果你想更快速的学习，可以看看 《视频教程 》 教程哟。

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

还是那句话，?? 为开源继绝学，我辈义不容辞！

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