Tina 小姐姐1. 项目概述
若依（RuoYi）是一套基于Spring Boot和Vue.js的企业级快速开发平台，提供了前后端分离和微服务两种架构版本。作为国内知名的开源项目，它已经广泛应用于各类企业管理系统开发中。我在实际项目中使用若依框架已有三年多时间，今天就来详细分享从零开始部署这两个版本的全过程。
前后端分离版（RuoYi-Vue）采用Spring Boot+Vue技术栈，架构简单清晰，适合中小型项目快速开发。而微服务版（RuoYi-Cloud）基于Spring Cloud Alibaba生态，包含网关、认证中心、业务模块等完整组件，更适合复杂的企业级应用场景。两个版本都提供了完善的权限管理、代码生成和系统监控功能。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备
2.1 基础环境要求
无论是部署前后端分离版还是微服务版，都需要先准备好以下基础环境：
- JDK 1.8+：推荐使用OpenJDK 11（LTS版本），注意配置JAVA_HOME环境变量
- MySQL 5.7+：生产环境建议使用MySQL 8.0，性能更好且支持更多特性
- Redis 5.0+：用作缓存和会话存储，建议使用最新稳定版
- Maven 3.6+：用于Java项目依赖管理和构建
- Node.js 14+：前端开发环境，推荐使用LTS版本（如16.x）
提示：在Windows环境下，建议使用Chocolatey包管理器一键安装这些组件；Linux/Mac用户可以使用SDKMAN!管理Java环境。
2.2 环境验证
安装完成后，在终端执行以下命令验证环境：
bash复制# Java环境验证
java -version
javac -version
# 数据库验证
mysql --version
# 缓存验证
redis-cli --version
# 构建工具验证
mvn -v
# 前端环境验证
node -v
npm -v
2.3 微服务版额外要求
若选择部署微服务版（RuoYi-Cloud），还需要准备：
- Nacos 2.0+：服务注册与配置中心，推荐2.0.4及以上版本
- Sentinel 1.8+：流量控制组件（可选）
- Seata 1.4+：分布式事务解决方案（可选）
3. 前后端分离版部署
3.1 项目结构与源码获取
若依前后端分离版采用标准的Maven多模块结构：
code复制RuoYi-Vue/
├── ruoyi-admin/ # 后台服务入口
├── ruoyi-common/ # 通用工具包
├── ruoyi-framework # 框架核心
├── ruoyi-generator # 代码生成
├── ruoyi-quartz/ # 定时任务
├── ruoyi-system/ # 系统模块
├── ruoyi-ui/ # 前端Vue项目
└── sql/ # 数据库脚本
获取源码有两种方式：
- Git克隆（推荐）：
bash复制git clone https://gitee.com/y_project/RuoYi-Vue.git
- 手动下载：
访问若依官网(https://www.ruoyi.vip)下载ZIP包
3.2 数据库初始化
- 创建数据库：
sql复制CREATE DATABASE `ry-vue` CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
2