若依安装教程（保姆级教程）

若依（RuoYi）是一款基于 Spring Boot 和 Vue.js 的开源项目，旨在为开发人员提供一个快速、高效的企业级应用开发平台。若依框架集成了多种常用的功能模块，便于开发人员进行定制化开发。以下是若依的主要特点和功能简介。

qq_73627657

6896人浏览 · 2024-07-02 12:14:14

qq_73627657 · 2024-07-02 12:14:14 发布

作为初学者在安装若依前后端分离版时遇到了许多困难，CSDN上大部分的教程都是直接从若依的安装开始，几笔带过系统要求，很少有前序准备工作的教程，故因此写此博客，整合一起，中间穿插了其他作者的优秀文章，为读者提供方便。

若依简介

若依（RuoYi）是一款基于 Spring Boot 和 Vue.js 的开源项目，旨在为开发人员提供一个快速、高效的企业级应用开发平台。若依框架集成了多种常用的功能模块，便于开发人员进行定制化开发。以下是若依的主要特点和功能简介

主要特点

1. 前后端分离：采用 Spring Boot 作为后端框架，Vue.js 作为前端框架，实现前后端分离，提升开发效率。
2. 模块化设计：系统功能模块化，开发人员可以根据需要选择性使用和扩展，降低系统耦合度。
3. 代码生成器：内置代码生成器，通过配置文件自动生成 CRUD（创建、读取、更新、删除）代码，减少重复劳动。
4. 权限管理：提供完善的权限管理功能，包括用户、角色、菜单权限等。
5. 多数据源支持：支持多数据源配置，方便开发人员对接不同的数据源。
6. 监控与日志管理：集成多种监控工具，提供系统运行状况的监控和日志管理功能。
7. 国际化支持：支持多语言切换，满足不同地区用户的需求。

主要功能模块

1. 系统管理：用户管理、角色管理、部门管理、菜单管理、岗位管理等基础功能模块。
2. 权限管理：基于 RBAC（基于角色的访问控制）的权限管理，支持细粒度的权限控制。
3. 系统监控：在线用户监控、定时任务管理、服务监控、系统日志等功能。
4. 内容管理：文章管理、公告管理、文件管理等内容管理功能。
5. 代码生成：自动生成前后端代码，支持一键生成增删改查代码，提高开发效率。
6. 数据权限：支持数据级别的权限控制，实现对不同用户的数据访问控制。
7. 其他模块：包括字典管理、参数设置、通知公告、操作日志等。

使用场景

- 企业级信息管理系统
- 电商系统后台管理
- 教育管理系统
- 其他需要快速开发的后台管理系统

若依作为一个开源项目，拥有良好的文档和活跃的社区支持，开发人员可以在此基础上进行二次开发，满足各种业务需求。

系统要求

JDK: 1.8及以上版本
Maven: 3.5及以上版本
Node.js: 12及以上版本
MySQL: 5.7及以上版本
Redis
IDEA
HeidiSQL/Navicat

JDK

Java Development Kit (JDK) 是学习和开发 Java 应用程序的基础，是IDEA运行Java的环境。

Oracle JDK 下载页面

JDK下载

JDK安装

双击运行安装程序

选择安装 JDK 的目录，默认情况下会安装在 C:\Program Files\Java\jdk-21。你也可以自定义安装路径，然后点击“下一步”。根据提示完成安装即可。

配置环境变量

打开系统属性
- 右键点击“此电脑”或“我的电脑”，选择“属性”，然后点击“高级系统设置”。
打开环境变量
- 在“系统属性”窗口中，点击“环境变量”按钮。
设置 JAVA_HOME
- 在“系统变量”部分，点击“新建”按钮，创建一个新的环境变量：
  - 变量名：JAVA_HOME
  - 变量值：JDK 的安装路径（例如 C:\Program Files\Java\jdk-21）
- 点击“确定”保存。
更新 PATH 变量
- 在“系统变量”部分，找到并选择 Path 变量，点击“编辑”按钮。
- 在“编辑环境变量”窗口中，点击“新建”，输入 %JAVA_HOME%\bin，然后点击“确定”。

注意

确保所有的更改都保存下来了，新建完之后都需要 “确定” 。

验证 JDK 安装

打开命令提示符
- 按 Win + R，输入 cmd，然后按回车键打开命令提示符。
检查 JDK 版本
- 在命令提示符中，输入 java -version 并按回车，应该会显示你安装的 JDK 版本信息。
- 再输入 javac -version，应该会显示你安装的编译器版本信息。

IntelliJ IDEA

IntelliJ IDEA 是一款功能强大的集成开发环境（IDE），广泛应用于 Java 开发。

下载 IntelliJ IDEA

访问 JetBrains 官方网站
- 打开浏览器，访问 JetBrains 官方网站，进入 IntelliJ IDEA 下载页面。
- 下载UItimate版本，有30天试用期，如果有学生邮箱，可以免费使用一年。
选择版本
- 在下载页面上，你会看到两个版本：Ultimate 和 Community。Ultimate 版本是付费的，适用于企业开发；Community 版本是免费的，适用于一般的 Java 开发。选择 Community 版本，点击“Download”按钮。如果有学生邮箱，可以免费使用一年。
选择操作系统
- 根据你的操作系统（Windows、macOS、Linux），选择相应的下载链接。本文以 Windows 操作系统为例。
下载安装包
- 点击“Download”按钮后，浏览器会开始下载 IntelliJ IDEA 的安装包。

安装 IntelliJ IDEA

运行安装程序
- 下载完成后，找到下载的安装文件（例如 ideaIU-2024.1.4.exe或ideaIC-2024.1.4.exe），双击运行安装程序。
开始安装
- 安装程序启动后，点击“Next”按钮。
选择安装目录
- 选择安装 IntelliJ IDEA 的目录，默认情况下会安装在 C:\Program Files\JetBrains\IntelliJ IDEA Community Edition。你可以自定义安装路径，然后点击“Next”按钮。
选择安装选项
- 你可以选择创建桌面快捷方式、关联 .java 文件等选项。根据需要进行选择，然后点击“Next”按钮。
选择 Start Menu 目录
- 选择 Start Menu 的文件夹，默认即可，点击“Install”按钮开始安装。
完成安装
- 安装程序会自动进行安装，等待安装完成，点击“Finish”按钮。

初次运行 IntelliJ IDEA

启动 IntelliJ IDEA
- 安装完成后，双击桌面上的 IntelliJ IDEA 图标，启动 IDE。
导入设置
- 如果是首次安装，可以选择“不导入设置”（Do not import settings），然后点击“OK”按钮。
激活 IntelliJ IDEA
- 对于 Community 版本，可以跳过激活步骤，直接点击“Evaluate for free”。

配置 JDK

打开项目
- 启动 IntelliJ IDEA 后，点击“New Project”创建新项目。
设置项目 JDK
- 在“New Project”窗口中。
选择 JDK 安装目录
- 浏览到你之前安装的 JDK 目录（例如 C:\Program Files\Java\jdk-21），选择该目录，然后点击“OK”按钮。
完成项目创建
- 配置好 JDK 后，点击“Next”按钮，然后选择项目模板或直接创建空项目，最后点击“Finish”按钮。

Maven

Apache Maven 是一个强大的项目管理和构建自动化工具，广泛应用于 Java 项目开发。

下载 Maven

访问 Maven 官方网站
- 打开浏览器，访问 Maven 官方下载页面。
选择 Maven 版本
- 在下载页面上，你会看到多个版本的 Maven。选择最新的稳定版本，通常页面上会推荐一个版本。
- 点击 apache-maven-3.x.x-bin.zip 或 apache-maven-3.x.x-bin.tar.gz 链接（这里以 zip 格式为例）开始下载。我下载的是：

安装 Maven

解压缩文件
- 下载完成后，找到下载的压缩文件（例如 apache-maven-3.9.8-bin.zip），右键选择“解压到当前文件夹”或使用你喜欢的解压工具解压文件。
- 将解压后的文件夹重命名为 maven 或其他易于识别的名称，并移动到你喜欢的安装目录（例如 C:\Users\24420\Downloads\apache-maven-3.9.8）。

配置环境变量

打开系统属性
- 右键点击“此电脑”或“我的电脑”，选择“属性”，然后点击“高级系统设置”。
打开环境变量
- 在“系统属性”窗口中，点击“环境变量”按钮。
设置 M2_HOME 和 MAVEN_HOME
- 在“系统变量”部分，点击“新建”按钮，创建两个新的环境变量：
  - 变量名：M2_HOME
  - 变量值：Maven 的安装路径（例如 C:\Users\24420\Downloads\apache-maven-3.9.8）
  - 变量名：MAVEN_HOME
  - 变量值：Maven 的安装路径（例如 C:\Users\24420\Downloads\apache-maven-3.9.8）
- 分别点击“确定”保存。
更新 PATH 变量
- 在“系统变量”部分，找到并选择 Path 变量，点击“编辑”按钮。
- 在“编辑环境变量”窗口中，点击“新建”，输入 %M2_HOME%\bin，然后点击“确定”。

注意

之前我尝试过安装在D盘，在cmd运行 mvn -v 时会有安装不完整和配置不对的报错，建议大家还是安装在C盘，个人经历，欢迎成功的朋友评论区交流。

验证 Maven 安装

重新启动命令提示符
- 关闭所有命令提示符窗口，重新打开一个新的命令提示符窗口。
检查 Maven 版本
- 在命令提示符中，输入以下命令并按回车键
- 正常情况下，应该显示 Maven 的版本信息以及 Java 的版本信息。

配置settings文件

这里引用其他的文章，配置settings文件，我也是通过这篇文章解决了依赖缺失的问题。

Node.js

Node.js 是一个开源的、跨平台的 JavaScript 运行环境，广泛用于开发服务器端应用程序。在安装若依（RuoYi）项目时，Node.js 是前端开发所必需的。

下载 Node.js

访问 Node.js 官方网站
- 打开浏览器，访问 Node.js 官方网站。
选择版本
- 在页面上，你会看到两个版本：LTS（长期支持版）和 Current（当前最新功能版）。建议选择 LTS 版本，因为它更稳定。
- 点击 LTS 版本的下载按钮，浏览器会开始下载适合你操作系统的安装包。

安装 Node.js

运行安装程序
- 下载完成后，找到下载的安装文件（例如 node-v20.14.0-x64.msi），双击运行安装程序。
选择安装组件
- 默认情况下，所有组件都会被选中，包括 Node.js 和 npm（Node.js 包管理器）。保持默认选项，点击“Next”按钮。
安装工具
- 你可以选择是否安装 Chocolatey 以便安装其他工具，建议保持默认设置，点击“Next”按钮。

添加到系统环境变量path中

验证 Node.js 安装

检查 Node.js 版本
检查 npm 版本

环境配置

https://blog.csdn.net/weixin_44893902/article/details/121788104?ops_request_misc=%257B%2522request%255Fid%2522%253A%2522171981214216800215088554%2522%252C%2522scm%2522%253A%252220140713.130102334..%2522%257D&request_id=171981214216800215088554&biz_id=0&utm_medium=distribute.pc_search_result.none-task-blog-2~all~top_positive~default-1-121788104-null-null.142^v100^pc_search_result_base8&utm_term=nodejs%E5%AE%89%E8%A3%85%E5%8F%8A%E7%8E%AF%E5%A2%83%E9%85%8D%E7%BD%AE&spm=1018.2226.3001.4187#t4https://blog.csdn.net/weixin_44893902/article/details/121788104?ops_request_misc=%257B%2522request%255Fid%2522%253A%2522171981214216800215088554%2522%252C%2522scm%2522%253A%252220140713.130102334..%2522%257D&request_id=171981214216800215088554&biz_id=0&utm_medium=distribute.pc_search_result.none-task-blog-2~all~top_positive~default-1-121788104-null-null.142%5Ev100%5Epc_search_result_base8&utm_term=nodejs%E5%AE%89%E8%A3%85%E5%8F%8A%E7%8E%AF%E5%A2%83%E9%85%8D%E7%BD%AE&spm=1018.2226.3001.4187#t4

MySQL

下载 MySQL

访问 MySQL 官方网站
- 打开浏览器，访问 MySQL 官方下载页面。
选择 MySQL 版本
- 在下载页面上，选择适合你操作系统的版本。例如，对于 Windows 操作系统，选择 Windows (x86, 64-bit), ZIP Archive。

安装 MySQL

按照指引完成安装，选择 developer default 版本即可，记住设置的密码，后面会用到。

测试

在搜索框中输入mysql

打开 MySQL 8.4 Command Line Client

输入在安装过程中设置的密码

出现以上画面即为成功

配置环境变量

打开系统属性
- 右键点击“此电脑”或“我的电脑”，选择“属性”，然后点击“高级系统设置”。
打开环境变量
- 在“系统属性”窗口中，点击“环境变量”按钮。
更新 PATH 变量
- 在“系统变量”部分，找到并选择 Path 变量，点击“编辑”按钮。添加MySQL的bin路径

验证是否配置成功

打开cmd
1. 输入
```
mysql -u root -p
```
2. 输入密码

HeidiSQL

HeidiSQL 是一个功能强大且免费的开源数据库管理工具，广泛用于管理 MySQL 数据库。也可以使用Navicat，本文主要使用HeidiSQL进行数据库管理（我只会这个）

下载和安装 HeidiSQL

访问 HeidiSQL 官方网站
1. HeidiSQL下载链接
启动HeidiSQL
1. 密码是设置MySQL数据库是设置的密码
进入HeidiSQL
1. 上述图片是设置好RuoYi-Vue-master中的sql文件后的展示，后续会给出操作步骤

Redis

Redis 是一个开源的内存数据结构存储系统，广泛应用于缓存、消息队列等领域。

下载redis

redis的下载可以在cmd中进行
1. 首先要下载wsl
  1. install wsl on Windows
  2. 在cmd中输入
```
wsl --install
```
2. 下载redis
  1. install redis on Windows
  2. Add the repository to the apt index, update it, and then install
```
sudo apt-get update
sudo apt-get install redis
```

验证

若依

为什么需要这些配置

若依的后端使用 Spring Boot 框架，而 Spring Boot 是基于 Java 的，因此需要 JDK 来开发和运行若依的后端部分。而 Maven 是一个项目管理和构建工具，用于管理 Java 项目的依赖关系和构建过程，可以帮助开发者编译、测试和打包 Java 项目。IDEA是集成开发环境，用于编写、调试和运行 Java 代码。Node.js用于运行JavaScript代码，若依的前端部分使用 Vue.js 框架，开发和构建 Vue.js 应用需要使用 Node.js。Redis、HeidiSQL和MySQL可以归为一类，用于存储和管理数据。

若依前后端分离版下载

下载地址
1. 若依前后端分离版
  1. 两种下载方法皆可（我使用的是下载zip文件）
解压缩到指定地址
1. 进入目录
2. sql文件夹下有两个sql类型文件
  1. 将其运行在HeidiSQL中
    1. 创建新的数据库，命名ruoyi
    2. 选中创建的数据库
      1. 左上角点击文件，加载sql文件或运行sql文件，如果ruoyi没有反应就重启HeidiSQL
3. 修改application.yml和application-druid.yml文件
  1. 在application.yml文件中找到redis配置，修改密码为在cmd设置的密码
  2. 在application-druid.yml中修改数据库的名字和密码
4. 打开IntelliJ IDEA
  1. 进入settings
  2. 详细步骤返回Maven配置settings
5. 启动后端项目（保证redis和MySQL服务正常）
  1. 运行RuoYiApplication.java
    1. 出现若依标志证明启动成功
6. 启动前端项目（确保node.js配置成功）
  1. 打开cmd，改变路径到ruoyi-ui目录下
    1. 安装依赖
```
npm install
```
    2. 运行前端
```
npm run dev
```