若依RuoYi项目环境搭建教程（RuoYi-Vue + RuoYi-Vue3版本）

最新推荐文章于 2025-07-09 18:07:49 发布
最新推荐文章于 2025-07-09 18:07:49 发布
阅读量1.3w 收藏 113
点赞数 49
CC 4.0 BY-SA版权
分类专栏： 若依 文章标签： vue.js 前端 javascript 后端 java
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_52152676/article/details/142151149

文章目录

一、开发脚手架选择

当下热门流行的5个开源的Java项目快速开发脚手架。

  1. Guns
  2. pig
  3. RuoYi
  4. Jeecg-boot
  5. iBase4J
  6. …

本次主要介绍Java热门快速开发脚手架——若依（RuoYi），包括若依介绍、环境搭建教程。

二、RuoYi框架

1、介绍

若依（Ruoyi）框架是一款基于 Spring Boot 2.5.5、Spring Cloud 2020.0、OAuth2 与 JWT 鉴权等核心技术，同时也支持Spring Security、Apache Shiro 等多种安全框架，以及 Mybatis、JPA 等流行持久化框架，提供了许多常用的功能模块，包括系统管理、监控管理、任务调度、代码生成、文件上传、高德地图等功能的快速开发平台。

若依官网:http://ruoyi.vip
演示地址:http://vue.ruoyi.vip
前后端分离版本代码下载:https://gitee.com/y_project/RuoYi-Vue
官方开发手册：https://doc.ruoyi.vip/ruoyi/

2、版本发展

从2018年一直开源维护到今天：

3、为什么选择若依

  • 框架使用人群与热度分析：用户基数大，全网火爆，具有代表性，很多中小型公司脚手架的首选。
  • gitee：

  • github：

  • 完全开源，免费商用，不光是代码，文档也是开源的。有些项目是代码开源，文档收费，虽然不贵，但免费的显然更香。
  • 商用友好，MIT许可，想怎么改就怎么改，想怎么发版就怎么发版，完全不用担心侵权。
  • 开源开发文档：中文支持友好，照着文档把项目跑起来并使用功能，上手相对容易。
  • 社区活跃度：有一定的社区支持，虽然不如一些大型开源项目那样活跃，但对于解决常见问题和获取技术支持还是有帮助的。更新速度和频率也比较高。

4、优缺点

  • 优点 ：

（1）高效率开发：引入如代码生成等多种能力，可自动生成初代代码，只需关注业务逻辑实现。

（2）低代码/封装：只提供必要的封装以保持框架的简洁性，可灵活配置。

（3）前后端分离：前后端领域无关，简化开发，提高效率，通过屏蔽前后端技术栈，让前后端工程师更关注自己的业务以及交互效果。

（5）支持多种安全框架：OAuth2、JWT、Spring Security、Apache Shiro 都可以选择。

（6）权限认证使用Jwt，支持多终端认证系统。支持加载动态权限菜单，多方式轻松权限控制。

（6）支持多种持久化框架：Mybatis、JPA都可以选择。

（7）集成多种常用模块：系统管理、监控管理、任务调度、代码生成、文件上传、高德地图等功能的快速开发平台。

  • 缺点 ：

（1）使用RuoYi框架需要一定的JavaWeb开发经验，在没有JavaWeb基础的情况下，上手可能会困难。

（2）提供的代码生成器可能不能满足需求，并且代码生成的质量还需要另加一定的开发工作。

（3）支持的功能还比较简单，但是这也使得它更加轻量级，通用性更好。

（4）适合初学者，它满足一些没有技术积累的小型开发团队或者软件公司的快速开发的需求，这一点是值得肯定的，也是它在国内流行的主要原因。

5、项目内置功能

（1）用户管理：用户是系统操作者，该功能主要完成系统用户配置。

（2）部门管理：配置系统组织机构（公司、部门、小组），树结构展现支持数据权限。

（3）岗位管理：配置系统用户所属担任职务。

（4）菜单管理：配置系统菜单，操作权限，按钮权限标识等。

（5）角色管理：角色菜单权限分配、设置角色按机构进行数据范围权限划分。

（6）字典管理：对系统中经常使用的一些较为固定的数据进行维护。

（7）参数管理：对系统动态配置常用参数。

（8）通知公告：系统通知公告信息发布维护。

（9）操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询。

（10）登录日志：系统登录日志记录查询包含登录异常。

（11）在线用户：当前系统中活跃用户状态监控。

（12）定时任务：在线（添加、修改、删除)任务调度包含执行结果日志。

（13）代码生成：前后端代码的生成（java、html、xml、sql）支持CRUD下载 。

（14）系统接口：根据业务代码自动生成相关的api接口文档。

（15）服务监控：监视当前系统CPU、内存、磁盘、堆栈等相关信息。

（16）缓存监控：对系统的缓存信息查询，命令统计等。

（17）在线构建器：拖动表单元素生成相应的HTML代码。

（18）连接池监视：监视当前系统数据库连接池状态，可进行分析SQL找出系统性能瓶颈。

三、后端项目部署

1、拉取源码

  • 若依版本选择：RuoYi-Vue + RuoYi-Vue3
  • RuoYi-Vue版本，采用了前后端分离的单体架构设计。
  • 软件环境：JDK、MySQL、Redis、Maven、Node
  • 技术选型：Spring Boot、Spring Security、MyBatis、Jwt、Vue3、Element-Plus
# 项目后端
git clone https://gitee.com/y_project/RuoYi-Vue.git
# 项目前端
git clone https://gitee.com/ys-gitee/RuoYi-Vue3.git

2、环境要求

官方推荐演示版本
JDK >= 1.8JDK 17
MySQL >= 5.7.0MySQL 8.0
Redis >= 3.0Redis 3.2 (Win)
Maven >=3.0Maven 3.6.1
Node >= 12Node 16（Vue3）

3、Maven构建

使用idea打开项目后，等待环境检查(主要是Maven下载项目依赖)
在这里插入图片描述

4、MySQL相关

（1）导入SQL脚本

  • 创建数据库create schema ry-vue;
  • 执行下图的sql脚本文件，完成导入。

在这里插入图片描述

  • 导入后ry-vue库内置30张表

在这里插入图片描述

（2）配置信息

在ruoyi-admin模块下，编辑resources目录下的application-druid.yml，修改数据库连接。

# 数据源配置
spring:
    datasource:
        type: com.alibaba.druid.pool.DruidDataSource
        driverClassName: com.mysql.cj.jdbc.Driver
        druid:
            # 主库数据源
            master:
                url: 数据库地址
                username: 数据库账号
                password: 数据库密码

5、Redis相关

（1）启动Redis

在redis解压目录下，执行redis-server.exe redis.windows.conf启动。

（2）配置信息

在ruoyi-admin模块下，resources目录下的application.yml，可以设置redis密码等相关信息。

在这里插入图片描述

6、项目运行

在ruoyi-admin模块下，运行com.ruoyi.RuoYiApplication.java，出现如下图表示启动成功。

在这里插入图片描述

后端运行成功可以通过([http://localhost:8080)访问，但是不会出现静态页面，可以继续参考下面步骤部署ruoyi-ui前端，然后通过前端地址来访问。

四、前端项目部署

1、初始化项目

进入开发目录下，使用vscode命令code打开项目。

# 克隆Vue3项目（之前已经拉取过了不用执行）
git clone https://gitee.com/ys-gitee/RuoYi-Vue3.git

# 通过vscode打开项目（在RuoYi-Vue3目录里直接输入code也可以）
code ./RuoYi-Vue3

2、项目运行

在vscode终端中输入以下命令：

# 安装依赖
npm install

# 建议不要直接使用 cnpm 安装依赖，会有各种诡异的 bug。可以通过如下操作解决 npm 下载速度慢的问题
npm install --registry=https://registry.npmmirror.com

# 启动服务
npm run dev

打开浏览器，输入：([http://localhost:80) 默认账户/密码 admin/admin123）若能正确展示登录页面，并能成功登录，菜单及页面展示正常，则表明环境搭建成功。

在这里插入图片描述

ruoyi-vue（若依前后端分离版本）环境搭建 用eclipse 安装redis 后端配置 配置node环境 前端配置
java程序员的蜕变之路
11-10 3765
ruoyi-vue（若依前后端分离版本）环境搭建
若依项目环境搭建及使用
weixin_65808248的博客
09-27 1万+
根据官网搭建若依开发环境： 后台 1、git clone 将远程的若依项目拉取到本地 2、通过IDEA打开项目 3、将若依项目中 sql文件夹中的脚本在Navicat执行 4、修改数据库连接配置信息 5、修改项目基本配置信息---配置Redis 前台 1、npm install 2、npm run dev
若依框架(RuoYi)系列视频教程 RuoYi-Vue前后端分离版本 118集
06-10
├──01 项目概述.mp4 82.26M ├──02 项目运行.mp4 54.43M ├──03 构建发布到Linux.mp4 41.68M ├──04 系统菜单介绍.mp4 64.41M ├──05 开发环境运行.mp4 34.77M ├──06 表结构介绍.mp4 76.26M ├──07 目录文件介绍.mp4 65.53M ├──08 主配置文件介绍.mp4 69.64M ├──09 Spring Boot 简介.mp4 32.75M ├──10 Spring Security 简介.mp4 18.37M ├──100 主子表代码生成详解.mp4 32.85M ├──101 3.4.0版本更新介绍.mp4 122.82M ├──102 使用undertow容器.mp4 23.32M ├──103 实现优雅关闭应用.mp4 13.40M ├──104 实现swagger文档增强.mp4 14.83M ├──105 实现excel表格增强.mp4 45.81M ├──106 实现mybatis增强.mp4 67.43M ├──107 实现离线IP地址定位.mp4 35.40M
若依前后端分离项目本地和线上部署实战
sinat_37012541的博客
04-09 3042
Nginx 专注于快速和有效地提供静态文件，例如 HTML、CSS、JavaScript 和图像文件。与之相比，Tomcat 是一个 Java 应用服务器，不如 Nginx 专注于处理静态文件效率高。Nginx 是一个轻量级的服务器，具有高性能和低内存消耗。相比之下，Tomcat 是一个相对重量级的应用服务器，它可能会消耗更多的系统资源。Nginx 提供了强大的缓存和压缩功能，可以帮助提高前端资源的加载速度和用户体验。如果需要负载均衡、反向代理或缓存静态资源，Nginx 提供了更灵活和强大的功能。
【web应用】若依框架Vue3前端开发深度指南：从架构设计到工程化实践
质量是一次就把事情做对
06-24 1452
若依Vue3企业级框架解析：技术演进与开发实践 摘要：本文系统解析若依Vue3前端开发体系，涵盖其技术架构与核心实践。该框架基于Vue3+Element Plus+Vite4技术栈，采用JavaScript与TypeScript双轨制开发策略：JavaScript适用于快速原型验证和动态表单等场景，TypeScript则为用户管理等复杂业务提供类型安全保障。架构设计方面，实现了响应式布局系统和组件化开发模式，包括动态路由控制、增强型表单组件封装等关键技术。通过工程化实践，如接口文档自动生成和代码生成工具，显
Windows RuoYi-Cloud 开发环境搭建
可乐很好喝
07-01 640
本文详细介绍了软件开发环境的搭建步骤，包括Java、IDEA、Node.js等工具的安装方法，以及项目环境配置流程。内容涵盖Redis、MySQL数据库配置，Nacos持久化设置，前后端服务启动，并针对常见问题（如npm脚本执行限制、包安装失败等）提供了解决方案。文章还包含若依微服务系统的部署指南和相关参考链接，为开发人员提供了一套完整的环境搭建与问题排查方案。
[RuoYi-Vue] - 3. 功能详解 - 系统管理
人生需要动态规划 学习需要贪心算法
07-15 726
RuoYi-Vue 系统管理的功能详细介绍
ruoyi(若依vue3 ) 整合 Spring AI Alibaba 实际应用(4) linux 环境 字体问题,jdk8和 jdk17共存问题
AI懒虫
04-18 589
ruoyi(若依vue3.0 ) 整合 Spring AI Alibaba 实际应用(4) linux 环境 字体问题,jdk8和 jdk17共存问题
若依管理系统搭建教程，ruoyi-vue环境搭建
m0_61634551的博客
01-21 3397
清理 node_modules 重新安装，试了不管用，最后直接使用下面的命令安装vue-cli-service解决了。在开发react-native的时候，不要使用cnpm，cnpm安装的模块路径比较奇怪，packager不能正常识别。所以，为了方便开发，我们最好是直接永久使用淘宝的镜像源，直接命令行的设置。打包Web工程，生成war/jar包文件。在执行运行项目命令之前，先运行这个命令。3.2设置参数，解决报错。
RuoYi-Vue若依 环境搭建 速成
制定持续可量化的目标，不断坚持。
10-21 1754
RuoYi-Vue若依 环境搭建 速成
RuoYi环境搭建
u013473447的专栏
11-24 1443
本文旨在详细介绍RuoYi框架的环境部署过程，帮助开发者快速搭建起一个稳定、高效的开发环境。通过本文的指导，开发者将能够了解到RuoYi框架的源码获取、环境要求、Maven构建、MySQL及Redis配置等关键步骤，从而能够顺利地将RuoYi框架应用到实际项目中。例如：以上就是今天要讲的内容，本文仅仅简单介绍了pandas的使用，而pandas提供了大量能使我们快速便捷地处理数据的函数和方法。
若依ruoyi ruoyi-vue ruoyi-cloud 微服务全网最全视频教程网盘资源
12-25
若依ruoyi ，ruoyi-vue， ruoyi-cloud， 微服务全网最全视频教程网盘资源 若依框架系列视频教程(RuoVi-Vue前后端分高版本) 01 项目概述,mp4 02 项目运行,mp4 03 构建发布到 RuoYi-Cloud 微服务版本视频课程目录 ├...
RuoYi-Vue-fast-master_ruoyi项目_vuefast_若依前后端分离项目_
10-03
"RuoYi-Vue-fast-master" 是一个基于Vue.js框架的开源项目，名为"若依前后端分离项目"，其核心目标是提供一个高效、快速的开发环境，用于构建现代Web应用程序。该项目采用了Vue.js的最新版本，结合了现代化的前端...
RuoYi-Vue-Plus 是重写 RuoYi-Vue
03-07
RuoYi-Vue-Plus 是一款基于 Vue.js 框架的后台管理系统，它是 RuoYi-Vue 的全新升级版，专为分布式集群和多租户环境进行了深度优化。在原有框架的基础上，RuoYi-Vue-Plus 进行了重大改进，旨在提供更加稳定、高效且...
基于若依Vue框架的RuoYi-Vue-PMS设备管理系统设计源码
10-01
基于若依Vue框架的RuoYi-Vue-PMS设备管理系统是一款专业的设备管理软件，该系统的设计源码已经被封装成压缩包文件，供开发者下载使用。该系统包含多个文件，涉及后端的Java文件、前端的Vue、SVG、JavaScript等文件，...
RuoYi（若依）框架的介绍与基本使用（超详细分析）
热门推荐
只会写bug
11-26 1万+
RuoYi（若依）是一个基于Spring Boot和Spring Cloud的企业级快速开发平台。它集成了多种常用的技术栈和中间件，旨在帮助企业快速构建稳定、高效的应用系统。以下是关于RuoYi框架的详细介绍和基本使用教程，涵盖了从环境搭建到核心功能的使用。
一个基于若依(ruoyi-vue3)的小项目部署记录
最新发布
qq_37372909的博客
07-09 808
摘要：作者帮助朋友部署一个基于若依框架的任务管理系统，采用＊＊＊服务器和xyz域名绕过备案流程。本地调试时先后配置了MySQL数据库、Node.js环境、Vue脚手架等工具，解决了npm证书过期等问题。服务器部署阶段，前端使用Nginx代理dist目录，后端通过bat文件运行jar包，并配置Nginx反向代理解决前后端端口不一致问题（前端80端口，后端8080端口）。最终完成域名解析后，系统通过www.xxx.xyz域名正常访问。整个部署过程涉及Java/Vue技术栈和云服务配置，展现了全栈部署能力。
RuoYi-Vue 和 Vue3 快速为你所用（毕设系统）
卿着飞翔
06-07 344
摘要：本文介绍了如何使用RuoYi-Vue和Vue3快速搭建毕设系统。内容包括：1)后端部署，通过git拉取SpringBoot3分支项目，配置数据库和Redis；2)前端部署，安装依赖并运行；3)开发员工管理功能，通过代码生成器自动创建模块，完成增删改查功能。该系统提供完整的权限管理和代码生成功能，可快速实现业务模块开发，适合作为毕设或企业级项目的基础框架。
若依系统快速搭建指南
2301_82048439的博客
07-03 1271
环境变量设置、npm config set registry。enable all to import、子模块验证。关联模块：与部门管理功能相关的代码通常集中在此处。vue.config.js代理配置、跨域处理。需16.x以上版本，配置npm淘宝镜像。Redis服务启动与图形化工具使用。Vue模板选择、菜单权限SQL执行。无密码连接配置、RDM可视化工具。字符集设为utf8、表关系检查。Node.js安装与版本要求。执行SQL文件创建表结构。0号库索引、缓存数据结构。依赖自动导入与模块检查。
若依环境配置
03-22
### RuoYi 若依框架多环境配置方法 在实际开发中，为了适应不同阶段的需求（如开发、测试和生产），通常需要对项目进行多环境配置。RuoYi 若依框架提供了灵活的解决方案来满足这一需求。 #### 配置文件结构 RuoYi 使用 Spring Boot 的特性支持多环境配置，主要依赖于 `application.yml` 或 `application.properties` 文件以及其变体文件。以下是具体的配置方式： 1. **默认配置文件** 默认情况下，项目的根路径下会有一个名为 `application.yml` 的文件，用于存储全局通用的配置项[^1]。 2. **多环境配置文件命名规则** 多环境配置可以通过创建多个以 `-profile` 结尾的 YAML 文件实现，例如： - `application-dev.yml`: 开发环境专用配置； - `application-test.yml`: 测试环境专用配置； - `application-prod.yml`: 生产环境专用配置； 3. **激活指定环境** 在启动应用时，通过设置 JVM 参数或者环境变量来指定当前使用的环境。例如，在命令行中可以这样操作： ```bash java -Dspring.profiles.active=dev -jar ruoyi.jar ``` 上述命令表示加载 `application-dev.yml` 中的配置作为当前运行环境下的参数。 4. **具体配置示例** 假设我们需要为数据库连接定义不同的 URL 和用户名密码，则可以在各个环境中分别设定如下内容： #### application-dev.yml (开发环境) ```yaml spring: datasource: url: jdbc:mysql://localhost:3306/dev_db?useUnicode=true&characterEncoding=utf8&serverTimezone=UTC username: dev_user password: dev_password ``` #### application-test.yml (测试环境) ```yaml spring: datasource: url: jdbc:mysql://test-server:3306/test_db?useUnicode=true&characterEncoding=utf8&serverTimezone=UTC username: test_user password: test_password ``` #### application-prod.yml (生产环境) ```yaml spring: datasource: url: jdbc:mysql://prod-server:3306/prod_db?useUnicode=true&characterEncoding=utf8&serverTimezone=UTC username: prod_user password: prod_password ``` 5. **动态切换环境** 如果希望在不重启服务的情况下动态调整环境，可通过集成 Apollo 或 Nacos 等分布式配置中心工具完成更高级别的管理功能。 --- ### Bean 调用实例补充 除了上述提到的基础配置外，还可以利用 Spring 提供的强大容器机制注入自定义业务逻辑组件。比如下面这个例子展示了如何调用定时任务中的某个方法传递参数给它处理数据流的情况： ```java // 注入 Task 类对象到 Controller 层或其他地方使用 @Autowired private RyTask ryTask; public void executeCustomLogic() { String result = ryTask.ryParams("customParam"); } ``` 这里传入 `"customParam"` 字符串形式的数据会被映射至目标函数内部进一步解析执行相应动作[^2]。 ---
评论 3
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值