若依框架入门指南：快速上手SpringBoot+前后端分离版

若依（RuoYi）是一款基于SpringBoot的快速开发平台，集成了权限管理、代码生成、监控管理等功能。本文将以SpringBoot + Vue前后端分离版本为例，带你快速上手若依框架。

---

一、环境准备

1. 基础环境：

   • JDK 1.8+
   • MySQL 5.7+
   • Redis 5.0+
   • Maven 3.6+
   • Node.js 14+（前端）

2. 下载项目：

   # 后端项目
   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=UTC
        username: root
        password: 123456

执行/sql目录下的SQL脚本初始化数据库。

2. Redis配置

修改ruoyi-admin/src/main/resources/application.yml：

# Redis配置
redis:
  host: localhost
  port: 6379
  password: 
  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 {
    @Autowired
    private ISysUserService userService;

    @GetMapping("/list")
    public TableDataInfo list(SysUser user) {
        startPage();  // 分页处理
        List<SysUser> list = userService.selectUserList(user);
        return getDataTable(list);  // 返回分页数据
    }
}

2. 代码生成器（重点功能）

1. 创建数据表：在MySQL中创建业务表
2. 导入代码生成：系统工具 → 代码生成 → 导入表
3. 修改配置：设置包路径、模块名等
4. 生成代码：生成ZIP包并解压到对应目录
5. 重启项目：新功能自动注册到菜单

---

五、权限管理实现

基于RBAC（角色-权限）模型，通过注解控制权限：

// 权限控制示例
@RequiresPermissions("system:user:list") // 需要用户列表权限
@GetMapping("/list")
public TableDataInfo list(SysUser user) {
    // ...
}

// 角色控制示例
@RequiresRoles("admin") // 需要admin角色
@GetMapping("/adminOnly")
public String adminMethod() {
    return "管理员专属内容";
}

---

六、常见功能扩展

1. 添加新API接口

1. 在controller包新建控制器
2. 在service包创建服务接口及实现
3. 在mapper包编写MyBatis Mapper

2. 自定义页面

1. 在前端views目录创建Vue组件
2. 在router/index.js配置路由
3. 通过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