大家好本篇是Ruoyi 快速入门教程专门写给零基础、第一次接触 Ruoyi 框架的小伙伴。很多刚学 Java 后端、做管理系统的同学都会用到 Ruoyi 这个快速开发框架但刚上手时容易不知道从哪开始、环境怎么搭、项目怎么跑。这篇文章我会从环境准备、项目下载、启动运行、基础使用一步步带大家入门全程保姆级讲解看完就能自己把 Ruoyi 跑起来开始做自己的后台系统。若依官方针对不同开发需求提供了多个版本的框架每个版本都有其独特的特点和适用场景前后端混合版本RuoYi结合了SpringBoot和Bootstrap的前端开发框架适合快速构建传统的Web应用程序其中前端和后端代码在同一项目中协同工作。前后端分离版本RuoYi-Vue利用SpringBoot作为后端开发框架与Vue.js结合实现了前后端分离的开发模式。这种架构有助于提高开发效率前后端可以独立开发和部署更适合现代化的Web应用开发。微服务版本RuoYi-Cloud基于Spring Cloud Alibaba微服务架构为构建大型分布式系统提供了完整的解决方案。它支持服务发现、配置管理、负载均衡等微服务特性适合需要高可扩展性和高可用性的企业级应用。移动端版本RuoYi-App采用Uniapp进行开发结合了Vue.js的优势可以实现跨平台的移动端应用开发。一次编写多端运行的能力使得它成为开发iOS和Android应用的理想选择。这些版本的框架为开发者提供了多样化的选择无论是传统的Web应用、现代化的前后端分离应用还是复杂的微服务架构和跨平台的移动端应用都能找到合适的若依框架版本来满足开发需求。非官方若依框架因其强大的功能和灵活性吸引了众多第三方开发者基于其核心架构进行扩展和优化从而形成了丰富的生态系统。这些扩展不仅增强了若依框架的功能性也满足了开发者在不同场景下的具体需求。例如RuoYi-Vue3前端升级Vue3 Element Plus Vitehttps://github.com/yangzongzhuan/RuoYi-Vue3RuoYi-Vue-Plus后端集成Mybatis-Plus、Hutool、OSS存储、分布式锁等组件https://gitee.com/dromara/RuoYi-Vue-Plus这些扩展版本的推出使得若依框架能够更好地适应不同规模和类型的项目需求从小型快速开发到大型企业级应用都能提供相应的解决方案。开发者可以根据自己的具体需求选择合适的版本进行开发。RuoYi-VueRuoYi-Vue版本采用了前后端分离的单体架构设计软件环境JDK、MySQL 、Redis 、Maven、Node技术选型Spring Boot、Spring Security、MyBatis、Jwt、Vue3、Element-Plus官方网址https://gitee.com/y_project/RuoYi-Vue扩展地址https://gitee.com/ys-gitee/RuoYi-Vue3官方推荐课程版本JDK 1.8JDK 11Mysql 5.7.0MySQL 8Redis 3.0Redis 5WinMaven 3.0Maven 3.6Node 12Node 16Vue3运行后端项目初始化项目Git下载通过idea克隆若依源码仓库地址https://gitee.com/y_project/RuoYi-Vue.git把仓库地址粘贴到URL上Maven构建使用idea打开项目后等待环境检查主要是Maven下载项目依赖MySQL相关的导入sql1、创建数据库create database ry-vue;2、执行下图的sql脚本文件完成导入3、导入后ry-vue库内置30张表配置信息在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: 数据库密码Redis相关启动在redis解压目录下执行redis-server.exe redis.windows.conf启动配置信息在ruoyi-admin模块下resources目录下的application.yml可以设置redis密码等相关信息项目运行在ruoyi-admin模块下运行com.ruoyi.RuoYiApplication.java出现如下图表示启动成功后端运行成功可以通过([http://localhost:8080 )访问但是不会出现静态页面可以继续参考下面步骤部署ruoyi-ui前端然后通过前端地址来访问。运行前端项目初始化项目进入开发目录下使用vscode命令code打开项目# 克隆vue3项目 git clone https://gitee.com/ys-gitee/RuoYi-Vue3.git # 通过vscode打开项目 code ./RuoYi-Vue3项目运行在vscode终端中输入以下命令# 安装依赖 npm install # 建议不要直接使用 cnpm 安装依赖会有各种诡异的 bug。可以通过如下操作解决 npm 下载速度慢的问题 npm install --registryhttps://registry.npmmirror.com # 启动服务 npm run dev打开浏览器输入([http://localhost:80) 默认账户/密码admin/admin123若能正确展示登录页面并能成功登录菜单及页面展示正常则表明环境搭建成功