概述
若依（Ruo-Yi）是国内流行的开源快速开发平台，凭借完善的权限体系和强大的代码生成器，成为许多开发者搭建后台管理系统的首选。升级后的 RuoYi-Vue3 版本基于 Vue3 和 Spring Boot 打造，融合了 Vite 秒级热更新、Composition API 等现代化特性，显著提升了企业级后台的开发效率。
本文将围绕技术栈、核心功能及快速上手等方面展开说明，帮助开发者理解并应用该框架。
框架核心优势
相比传统开发模式和旧版 Vue2 版本，RuoYi-Vue3 具备以下显著优势：
- 前后端彻底分离：前端 Vue3 与后端 Spring Boot 独立部署，通过 API 接口通信，协作更高效；
- 高效代码生成：核心代码生成器一键生成 CRUD 前后端代码，减少重复劳动；
- 企业级权限体系：内置 RBAC 模型，支持菜单级、按钮级、数据级三重权限控制，满足合规需求；
- 开箱即用：用户、角色、菜单、监控等基础模块已完整实现，无需从零搭建；
- 现代化技术栈：采用 Vite 构建（性能优于 Webpack）、Element Plus 组件库及 TypeScript 支持，开发体验良好。
技术栈详解
后端技术栈（Spring Boot）
- SpringBoot 2.7.x/3.x（核心框架）
- SpringSecurity + JWT（认证授权，保障接口安全）
- MyBatisPlus（ORM 框架，简化数据库操作）
- Druid（数据库连接池，稳定高效）
- Redis（缓存支持，提升系统性能）
- Quartz（定时任务调度）
- 多数据库兼容：MySQL/PostgreSQL/Oracle
前端技术栈（Vue3）
- Vue 3.3+（Composition API，灵活组织代码）
- Vite 4.x（构建工具，秒级热更新）
- Element Plus 2.x（UI 组件库，美观且实用）
- Vuex/Pinia（状态管理）
- Vue Router 4（动态路由配置）
- Axios（HTTP 请求封装）
- TypeScript（可选支持，类型安全）
核心功能模块
RuoYi-Vue3 的功能模块设计全面，无需额外开发即可满足大部分后台场景：
| 模块分类 | 核心功能 | 实用价值 |
|---|---|---|
| 系统管理 | 用户/角色/菜单/部门/岗位管理 | 搭建基础组织架构和权限载体 |
| 系统监控 | 在线用户、定时任务、Redis 缓存、服务监控 | 实时掌握系统运行状态 |
| 系统工具 | 代码生成器、字典管理、参数配置 | 提升开发效率，统一系统配置 |
| 权限控制 | 菜单级（可见范围）、按钮级（操作权限）、数据级（数据范围） | 精细化控制访问权限，保障数据安全 |
其中代码生成器是绝对核心亮点！操作流程如下：
- 选择数据库表；
- 配置模块名、包名、作者等信息；
- 点击生成，下载完整 zip 包；
- 解压到项目目录，前后端代码自动整合（含 Controller、Service、Vue 页面、API 接口）。
项目架构与目录结构
目录结构（分离版）
# 前端项目（ruoyi-vue）
ruoyi-vue/
├── public/ # 静态资源（如 favicon）
├── src/
│ ├── api/ # API 接口请求封装
│ ├── assets/ # 图片、样式等静态资源
│ ├── components/ # 通用组件（如分页、弹窗）
│ ├── router/ # 动态路由配置
│ ├── store/ # Vuex/Pinia 状态管理
│ ├── utils/ # 工具函数（如权限判断、请求拦截）
│ ├── views/ # 页面组件（核心业务页面）
│ ├── App.vue # 根组件
│ └── main.js # 入口文件
├── vite.config.js # Vite 构建配置
└── package.json # 依赖配置
# 后端项目（ruoyi-admin）
ruoyi-admin/
├── src/main/java/com.ruoyi/
│ ├── RuoYiApplication.java # 启动类
│ ├── controller/ # 接口控制器（接收前端请求）
│ ├── service/ # 业务逻辑层
│ ├── mapper/ # MyBatis Mapper 接口
│ ├── domain/ # 实体类（对应数据库表）
│ └── framework/ # 框架核心（权限、日志、异常处理）
└── pom.xml # Maven 依赖配置
前后端交互流程
携带 JWT Token -> Vue 组件发起 API 请求 -> Spring Security 认证 -> Controller 接收请求 -> Service 处理业务逻辑 -> Mapper 操作数据库/Redis -> 验证通过返回结果。
快速上手：启动项目
1. 环境准备
提前安装以下依赖：
- JDK 1.8+
- MySQL 5.7+/PostgreSQL/Oracle
- Redis（缓存支持）
- Node.js 14+（前端运行环境）
- Maven 3.6+（后端构建工具）
2. 克隆项目
# 克隆后端项目
git clone https://gitee.com/y_project/RuoYi-Vue.git
# 克隆前端项目（Vue3 分离版）
git clone https://gitee.com/y_project/RuoYi-Vue3.git
3. 启动项目
-
初始化数据库：
- 新建数据库（如
ruoyi-vue3）； - 导入后端项目中
sql目录下的初始化脚本； - 修改后端配置文件
application-druid.yml，配置数据库连接信息和 Redis 地址。
- 新建数据库（如
-
启动前端：
cd RuoYi-Vue3 npm install # 安装依赖 npm run dev # 启动前端，默认端口 5173 -
启动后端：
cd RuoYi-Vue/ruoyi-admin mvn spring-boot:run # 启动 Spring Boot 应用，默认端口 8080 -
访问系统：
- 浏览器打开
http://localhost:5173； - 默认账号/密码：admin/admin123。
- 浏览器打开
Vue3 vs Vue2 版本差异
| 特性 | RuoYi-Vue2 | RuoYi-Vue3 |
|---|---|---|
| Vue 版本 | Vue 2.x | Vue 3.x（Composition API） |
| 构建工具 | Webpack | Vite（秒级热更新） |
| UI 组件库 | Element UI | Element Plus |
| 性能 | 良好 | 更优（Tree-shaking 按需加载） |
| 开发体验 | Options API | Composition API（代码更灵活） |
| TypeScript | 不支持 | 原生支持（类型安全） |
适用场景与总结
RuoYi-Vue3 特别适合以下场景：
- 企业级后台管理系统（OA、ERP、CRM、CMS）；
- 权限控制复杂的业务系统；
- 快速原型开发（MVP）；
- 外包项目（交付快、成本低、维护简单）。
作为一款开源免费（MIT 协议可商用）的框架，RuoYi-Vue3 不仅具备成熟的企业级最佳实践（统一异常处理、接口响应封装、多环境配置），还有 30k+ Star 的活跃社区支持，官方文档详细、问题响应快。无论是新手快速入门，还是资深开发者提升效率，都是绝佳选择！