若依（RuoYi）是一款基于SpringBoot的快速开发平台，集成了权限管理、代码生成、监控管理等功能。本文将以SpringBoot + Vue前后端分离版本为例，带你快速上手若依框架。
一、环境准备
-
基础环境：
- JDK 1.8+
- MySQL 5.7+
- Redis 5.0+
- Maven 3.6+
- Node.js 14+（前端）
-
下载项目：
# 后端项目 git clone https://gitee.com/y_project/RuoYi-Vue.git# 前端项目 git clone https://gitee.com/y_project/RuoYi-Vue-Web.git
二、项目配置
1. 数据库配置
修改ruoyi-admin/src/main/resources/application-druid.yml：
# 数据源配置
spring:datasource:druid:master:url: jdbc:mysql://localhost:3306/ry-vue?useSSL=false&serverTimezone=UTCusername: rootpassword: 123456
执行/sql目录下的SQL脚本初始化数据库。
2. Redis配置
修改ruoyi-admin/src/main/resources/application.yml：
# Redis配置
redis:host: localhostport: 6379password: database: 0
三、启动项目
后端启动
运行RuoYiApplication.java中的main方法，控制台输出RuoYi启动成功即启动成功。
前端启动
cd RuoYi-Vue-Web
npm install # 安装依赖
npm run dev # 启动开发服务器
访问：http://localhost:80，使用默认账号admin/admin123登录。
四、基础功能使用
1. 代码结构说明
// 控制器示例
@RestController
@RequestMapping("/system/user")
public class SysUserController {@Autowiredprivate ISysUserService userService;@GetMapping("/list")public TableDataInfo list(SysUser user) {startPage(); // 分页处理List<SysUser> list = userService.selectUserList(user);return getDataTable(list); // 返回分页数据}
}
2. 代码生成器（重点功能）
- 创建数据表：在MySQL中创建业务表
- 导入代码生成：系统工具 → 代码生成 → 导入表
- 修改配置：设置包路径、模块名等
- 生成代码：生成ZIP包并解压到对应目录
- 重启项目：新功能自动注册到菜单
五、权限管理实现
基于RBAC（角色-权限）模型，通过注解控制权限：
// 权限控制示例
@RequiresPermissions("system:user:list") // 需要用户列表权限
@GetMapping("/list")
public TableDataInfo list(SysUser user) {// ...
}// 角色控制示例
@RequiresRoles("admin") // 需要admin角色
@GetMapping("/adminOnly")
public String adminMethod() {return "管理员专属内容";
}
六、常见功能扩展
1. 添加新API接口
- 在
controller包新建控制器 - 在
service包创建服务接口及实现 - 在
mapper包编写MyBatis Mapper
2. 自定义页面
- 在前端
views目录创建Vue组件 - 在
router/index.js配置路由 - 通过API与后端交互
七、项目结构示意图
ruoyi-admin
├── src/main/java
│ ├── com.ruoyi # 核心包
│ │ ├── common # 通用组件
│ │ ├── framework # 框架核心
│ │ └── system # 系统模块
│ └── resources
│ ├── mapper # MyBatis映射文件
│ └── static # 静态资源
总结
若依框架通过丰富的内置功能大幅提升开发效率，特别适合快速开发企业级应用。掌握代码生成器和权限管理即可完成80%的基础开发工作。遇到问题时，建议多查阅官方文档和社区讨论。
TIP：开发时重点关注以下目录：
ruoyi-common：通用工具类ruoyi-system：核心业务模块resources/templates：代码生成模板
若依官网：https://ruoyi.vip
官方文档：https://doc.ruoyi.vip