RuoYi-Vue-Pro 文档

Appearance

2026-06-11
2127
8.9m

快速启动（后端项目） ​

目标：使用 IDEA 工具，将项目 ruoyi-vue-pro 的后端项目运行起来 🛫 整个过程非常简单，预计 10 分钟就可以完成，取决于大家的网速。 ↓↓↓ 技术交流群，一起苦练技术基本功，每日精进 30 公里！↓↓↓ 交流群

# 👍 相关视频教程 ​

# 1. 克隆代码 ​

使用 IDEA 克隆 https://github.com/YunaiV/ruoyi-vue-pro 仓库的最新代码，并给该仓库一个 Star。 注意：不建议使用 Eclipse，因为它没有支持 Lombok 和 Mapstruct 插件。 克隆完成后，耐心等待 Maven 下载完相关的依赖。一定要注意：

  • ① 默认情况下，使用 master 分支，它对应 JDK 8 + Spring Boot 2.7 版本。
  • ② 如果你想体验 JDK 17/21 + Spring Boot 3.5 版本，需要切换到 master-jdk17 分支。 友情提示：项目的每个模块的作用，可见 《开发指南 —— 项目结构》 文档。 使用的 Spring Boot 版本较新，所以需要下载一段时间。趁着这个时间，胖友可以给项目添加一个 Star，支持下艿艿。 Star 一波

# 2. Apifox 接口工具 ​

点击 Apifox 首页，下载对应的 Apifox 桌面版。如下图所示： 为什么要下载 Apifox 桌面版？ 艿艿已经卸载 Postman，使用 Apifox 进行替代。国产软件，yyds 永远滴神！ 国内很多互联网公司，包括百度、阿里、腾讯、字节跳动等等在内，都在使用 Apifox 作为 API 工具。 Apifox 下载 解压后，双击进行安装即可。黑色界面，非常酷炫。 Apifox 界面 接口文档？ 阅读 《开发指南 —— 接口文档》 呀~~

# 3. 初始化 MySQL ​

友情提示？ 如果你是 PostgreSQL、Oracle、SQL Server、DM、大金 等其它数据库，也是可以的。 因为我主要使用 MySQL数据库为主，所以其它数据库的 SQL 文件可能存在滞后，可以加入 用户群 反馈。 项目使用 MySQL 存储数据，所以需要启动一个 MySQL 服务。 ① 创建一个名字为 ruoyi-vue-pro 数据库，【只要】 执行对应数据库类型的 sql 目录下的 ruoyi-vue-pro.sql SQL 文件，进行初始化。 导入 MySQL 数据库 ② 默认配置下，MySQL 需要启动在 3306 端口，并且账号是 root，密码是 123456。如果不一致，需要修改 application-local.yaml 配置文件。 修改配置文件 疑问：如果我不是 MySQL，想用其它数据库，怎么办？？？

# 5. 启动后端项目 ​

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

# 5.1 编译项目 ​

第一步，使用 IDEA 自带的 Maven 插件，进行项目的编译。如下图所示： 后端编译 【可选】也可以使用 Maven 命令编译：

  • 使用 IDEA 打开 Terminal 终端，在 根目录 下直接执行 mvn clean install package '-Dmaven.test.skip=true' 命令。
  • 如果执行报 Unknown lifecycle phase “.test.skip=true” 错误，使用 mvn clean install package -Dmaven.test.skip=true 即可。 ps：只有首次需要执行 Maven 命令，解决基础 pom.xml 不存在，导致报 BaseDbUnitTest 类不存在的问题。 整个过程，预计需要 1 分钟左右。成功后，控制台日志如下： [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 9.139 s (Wall Clock) [INFO] Finished at: 2024-05-03T18:56:03+08:00 [INFO] ------------------------------------------------------------------------

# 5.2 启动项目 ​

第二步，执行 YudaoServerApplication 类，进行启动。 启动还是报类不存在？ 可能是 IDEA 的 bug，点击 [File -> Invalidate Caches] 菜单，清空下缓存，重启后在试试看。 启动后端项目 启动完成后，使用浏览器访问 http://127.0.0.1:48080 地址，返回如下 JSON 字符串，说明成功。 友情提示：注意，默认配置下，后端项目启动在 48080 端口。 { "code": 401, "data": null, "msg": "账号未登录" } 如果报 “Command line is too long” 错误，参考 《Intellij IDEA 运行时报 Command line is too long 解决方法 》 文章解决，或者直接点击 YudaoServerApplication 蓝字部分！ “Command line is too long” 错误

# 5.3 启动其它模块 ​

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

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

友情提示：这是可选步骤，想要完整启动前端，可以直接看「7. 启动前端项目【完整】」小节噢！ 在 yudao-demo 项目中，提前编译好了前端项目的静态资源，无需安装 Node 等前端环境，可以直接体验和使用。操作步骤如下： ① 克隆 https://gitee.com/yudaocode/yudao-demo 项目，运行对应的启动类： 演示项目

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

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

# 666. 彩蛋 ​

至此，我们已经完成了项目 ruoyi-vue-pro 的启动。 胖友可以根据自己的兴趣，阅读相关源码。如果你想更快速的学习，可以看看 《视频教程 》 教程哟。 架构图 后面，艿艿会花大量的时间，继续优化这个项目。同时，输出与项目匹配的技术博客，方便胖友更好的学习与理解。 还是那句话，😆 为开源继绝学，我辈义不容辞！ 嘿嘿嘿，记得一定要给 https://github.com/YunaiV/ruoyi-vue-pro 一个 star，这对艿艿真的很重要。 Star 一波 .pageB img{width:80px!important;} .wwads-horizontal .wwads-text, .wwads-content .wwads-text{line-height:1;} 功能列表 快速启动（前端项目） ← 功能列表 快速启动（前端项目）→ Theme by Vdoing | Copyright © 2019-2026 芋道源码 | MIT License

  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式 × .windowRB{ padding: 0;} .windowRB .wwads-img{margin-top: 10px;} .windowRB .wwads-content{margin: 0 10px 10px 10px;} .custom-html-window-rb .close-but{ display: none; }
最近更新