项目简介#

内置功能模块#

RuoYi 提供了 18 个开箱即用的功能模块：

学习路线图#

整个路线拆成 12 个阶段，前 4 个阶段是技术基础，中间 4 个是核心业务模块，最后 4 个是高级特性：

阶段索引#

下面是每个阶段对应的文章。链接是站内绝对路径，跟着 base /blog 走：

1. 阶段一：项目概览与环境搭建
2. 阶段二：Spring Boot 基础与项目结构
3. 阶段三：MyBatis 与数据库操作
4. 阶段四：Shiro 权限框架
5. 阶段五：用户管理模块
6. 阶段六：角色与菜单管理
7. 阶段七：部门与岗位管理
8. 阶段八：字典与参数管理
9. 阶段九：日志管理
10. 阶段十：定时任务
11. 阶段十一：代码生成器
12. 阶段十二：系统监控

前端工程师的技术栈对照#

学 RuoYi 之前，先把前端里熟悉的模式映射到 Java 后台：

TIP

RuoYi 里最像前端的两个地方：

1. 代码生成器——类似前端的脚手架，根据数据库表生成 CRUD 代码
2. 树形结构——部门、菜单都是树形数据，和前端 Tree 组件逻辑一致

环境准备（一次性）#

后续每篇文章里的代码都假设你已经完成下面这些准备：

1
# 1. 装 JDK 17+（推荐 Eclipse Temurin 或 Oracle JDK）
2
java -version
3
# openjdk version "17.0.x" ...
4

5
# 2. 装 Maven 3.6+
6
mvn -v
7
# Apache Maven 3.9.x
8

9
# 3. 装 MySQL 5.7+ 或 8.0+
10
mysql --version
11
# mysql Ver 8.0.x
12

13
# 4. 装 Redis（可选，用于缓存和 Session）
14
redis-server --version
15
# Redis server v=7.x
16

17
# 5. 装一个 IDE：IntelliJ IDEA Community 免费且开箱即用
18
#    Eclipse 也可以，但 IDEA 对 Spring Boot 支持更好

1
# 克隆 RuoYi 项目
2
git clone https://github.com/yangzongzhuan/RuoYi.git
3
cd RuoYi
4

5
# 导入数据库脚本
6
# sql/ry_20240629.sql 是主库脚本
7
# sql/quartz.sql 是定时任务脚本
8
mysql -u root -p < sql/ry_20240629.sql
9
mysql -u root -p < sql/quartz.sql

1
spring:
2
  datasource:
3
    druid:
4
      master:
5
        url: jdbc:mysql://localhost:3306/ry?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
6
        username: root
7
        password: your_password

1
# 启动项目
2
mvn spring-boot:run
3
# 或者直接在 IDEA 里运行 RuoYiApplication.java
4

5
# 访问 http://localhost:80
6
# 默认账号：admin / admin123

项目结构速览#

1
RuoYi/
2
├── src/
3
│   ├── main/
4
│   │   ├── java/com/ruoyi/
5
│   │   │   ├── common/          # 公共模块（工具类、常量、异常）
6
│   │   │   ├── framework/       # 框架核心（Shiro、MyBatis、AOP）
7
│   │   │   ├── generator/       # 代码生成器
8
│   │   │   ├── quartz/          # 定时任务
9
│   │   │   ├── system/          # 系统模块（用户、角色、菜单、部门）
10
│   │   │   └── web/             # Web 层（Controller）
11
│   │   └── resources/
12
│   │       ├── mapper/          # MyBatis XML 映射文件
13
│   │       ├── static/          # 静态资源（前端页面）
14
│   │       ├── templates/       # Thymeleaf 模板
15
│   │       └── application.yml  # 配置文件
16
│   └── test/                    # 测试代码
17
├── sql/                         # 数据库脚本
18
├── pom.xml                      # Maven 配置
19
└── README.md                    # 项目说明

如何使用这个系列复习#

写这个系列时特意做了三件事，方便日后回来”扫一眼就想起来”：

1. 每篇文章都有”复习卡片”小节，把关键概念压缩成几行代码或一张表，不用重读正文也能回忆起要点。
2. 每个功能都配项目真实代码，代码块都标注了文件路径，可以直接在 IDEA 里定位。
3. 每个阶段都有架构图或流程图，帮助理解模块之间的关系。

推荐的复习节奏：

• 第一次学：按阶段顺序读，每篇结束在 IDEA 里把对应模块的代码翻一遍。
• 一周后：只看每篇的”复习卡片”和架构图，回忆不起来的再翻正文。
• 一个月后：把整个系列当作速查手册，遇到具体功能问题直接搜文章内的锚点。

WARNING

光读不写等于没学。每个阶段建议配一个小练习：

• 阶段一到四：跑通项目，理解启动流程
• 阶段五到八：给某个模块加一个新字段（如用户加”手机号”）
• 阶段九到十二：用代码生成器生成一个新模块，并集成到系统中

参考资源#

• RuoYi 官方文档：http://doc.ruoyi.vip
• RuoYi 在线演示：http://ruoyi.vip（admin/admin123）
• Spring Boot 官方文档：https://spring.io/projects/spring-boot
• MyBatis 官方文档：https://mybatis.org/mybatis-3/
• Shiro 官方文档：https://shiro.apache.org/
• GitHub 项目地址：https://github.com/yangzongzhuan/RuoYi

下一篇从最基础的项目结构和环境搭建开始，把”RuoYi 是怎么跑起来的”讲清楚。