若依环境部署教程
本文最后更新于：2025年4月13日
官网介绍：RuoYi 是一个 Java EE 企业级快速开发平台，基于经典技术组合（Spring Boot、Apache Shiro、MyBatis、Thymeleaf、Bootstrap），内置模块如：部门管理、角色用户、菜单及按钮授权、数据权限、系统参数、日志管理、通知公告等。在线定时任务配置；支持集群，支持多数据源，支持分布式事务。
以下是若以框架环境部署教程：
第一部分 准备操作
根据自己的操作系统安装如下软件：
| Windows | macOS | 系统版本要求 | |
|---|---|---|---|
| JDK 8 | 点我查看 | 点我查看 | JDK >= 8 |
| Intellij IDEA | 点我查看 | 点我查看 | 无版本要求 |
| Maven | 点我查看 | 点我查看 | Maven >= 3.0 |
| MySQL | 点我查看 | 点我查看 | MySQL >= 5.7 |
| DBeaver | 点我查看 | 点我查看 | 无版本要求 |
| Git | 点我查看 | 系统默认已安装 | 无版本要求 |
第二部分 拉取若依代码
1. 打开文件夹，找到一个你熟悉的位置，鼠标右键点击Git Bash Here，打开Git命令行窗口：
2. 使用Git拉取若依代码，以下两种方式任选其一：
- 国内用户建议在Gitee上拉取若依代码：
1 | |
- 如果你已经有Gitee账号（没有的小伙伴可以注册一个）并对SSH Key做了配置，可以执行如下命令拉取代码：
1 | |
3. 在Git命令行中，按Shift和Insert键粘贴上一步复制的命令：
笔记本用户可能还需要按Fn键，因为你的Insert键可能会被占用。
4. 代码拉取中，请耐心等待：
5. 拉取完成，此时关闭Git命令行窗口，我们发现此时有一个RuoYi的文件夹，点击进入：
6. 点击上方路径，鼠标右键，点击复制：
第三部分 加载并启动项目
3.1 Intellij IDEA导入后端项目
1. 打开Intellij IDEA，点击左上角File，点击Open：
2. 此时会弹出一个文件路径，将上一部分复制的文件路径，粘贴到上面的文件路径框中，完成后点击OK：
3. 此时会加载项目。按CtrlAltS，进入设置界面，按照下图所示找到Maven并进行配置：
4. （未出现下面情况的可以跳过这一步）导入后如果你的Maven项目也是下图这样，鼠标右键点击pom.xml，然后点击Add as Maven Project，加载Maven项目：
说明：如果你的IDEA没有侧边栏，如下图所示，点击左下角的图标即可显示侧边栏菜单。
5. 加载过程中会下载很多的依赖，需要保证网络畅通。等待一段时间后，Maven项目加载成功，此时IDEA左侧文件夹目录变成了模块图标，右侧Maven菜单中也存在对应的模块：
3.2 数据库操作
1. 打开DBeaver，按照下图所示连接数据库：
2. 鼠标右键选中数据库，鼠标右键点击新建数据库：
3. 这里我将数据库命名为ruoyi，字符集是utf8mb4，排序规则utf8mb4_0900_ai_ci，完成后点击确定：
4. 打开IDEA，在左侧找到sql文件夹，选中ry_xxx.sql，按CtrlShiftC，复制文件所在路径：
5. 打开DBeaver，在左侧找到并选中刚刚创建好的数据库，鼠标右键点击工具，选择执行脚本：
6. 按照下图所示完成SQL导入操作：
1 | |
如果出现这个窗口提示，选择是：
5. 导入完成，点击右下角取消：
3.3 启动项目
1. 打开IDEA，按照下图所示操作找到application-druid.yml配置文件：
2. 双击打开application-druid.yml，第九行数据库名称改为ruoyi；第10行用户名填写root即可，第11行密码是MySQL的root用户密码，如下图所示：
3. 点击右上角的Debug图标，以调试的方式启动：
4. 如果控制台出现如下图所示内容，说明若依后端项目启动成功！
（正常启动的小伙伴请忽略这部分内容）如果你在启动时报错，出现如下错误信息：
打开application.yml，找到服务器端口，将其改为其他端口，为了方便展示，我将其改为8888：
重新启动就不会报错啦：
5. 打开浏览器，在上方搜索框中输入localhost即可访问：
如果你修改了服务端口，访问地址是
localhost:端口号，这里我将端口号修改成了8888，因此访问地址是localhost:8888
6. 默认用户名是admin，密码admin123，验证码需要按照图片计算，完成后点击登录：
7. 进入主界面，admin用户登录成功！
