获课：789it.top/14915/

若依（RuoYi）是一款基于Spring Boot的快速开发平台，以其模块化设计、开箱即用的特性和丰富的功能模块受到开发者青睐。本文将详细介绍如何从零开始搭建若依框架开发环境，涵盖源码获取、环境准备、项目运行及常见问题解决，帮助您快速上手这一高效开发工具。

一、环境准备：开发前的必要条件

在开始搭建前，请确保您的开发环境满足以下要求：

1.1 基础环境

• 操作系统：Windows 10/11、macOS或Linux（推荐Ubuntu 20.04+）
• Java版本：JDK 1.8（若依官方推荐版本，部分新版本可能支持JDK 11+）
• 构建工具：Maven 3.6+（用于依赖管理）
• 数据库：MySQL 5.7+（或MariaDB 10.3+，需与项目配置匹配）
• 版本控制：Git（用于拉取源码）

1.2 开发工具（可选但推荐）

• IDE：IntelliJ IDEA（社区版或旗舰版）、Eclipse或VS Code（需安装Java插件）
• 数据库工具：Navicat、DBeaver或MySQL Workbench
• API测试工具：Postman（用于接口调试）

1.3 环境验证

• 通过命令行检查环境是否就绪：

  1java -version  # 确认JDK版本2mvn -v         # 确认Maven版本3git --version  # 确认Git版本4mysql --version # 确认MySQL版本

提示：若使用IntelliJ IDEA，可提前安装Lombok插件（若依大量使用Lombok简化代码）。

二、源码获取：从官方仓库到本地

若依框架的源码托管在GitHub和Gitee上，开发者可根据网络情况选择平台：

2.1 选择版本

若依提供多个版本，根据需求选择：

• 若依管理系统：基础版（单模块）或完整版（多模块）
• 若依微服务：基于Spring Cloud的分布式版本
• 若依Vue：前后端分离版本（需配合前端项目）

推荐新手：从若依管理系统（完整版）开始，功能全面且结构清晰。

2.2 拉取源码

方法一：通过Git命令克隆

1git clone https://gitee.com/y_project/RuoYi-Vue.git  # Gitee（国内速度快）2# 或3git clone https://github.com/yangzongzhuan/RuoYi-Vue.git  # GitHub

方法二：直接下载ZIP包

• 访问项目仓库页面，点击「Download ZIP」下载源码压缩包。
• 解压到本地目录（如D:\projects\ruoyi）。

2.3 目录结构解析

解压后，主要目录如下：

1ruoyi/2├── ruoyi-admin/       # 后端主模块（Spring Boot应用）3├── ruoyi-framework/   # 框架核心模块4├── ruoyi-system/      # 系统业务模块5├── ruoyi-quartz/      # 定时任务模块6├── sql/               # 数据库初始化脚本7└── pom.xml            # Maven总配置文件

三、数据库配置：初始化数据环境

若依依赖MySQL存储数据，需提前创建数据库并导入初始数据：

3.1 创建数据库

1. 登录MySQL（命令行或工具）：

   1mysql -u root -p

2. 执行以下命令（根据实际需求修改用户名和密码）：

   sql1CREATE DATABASE IF NOT EXISTS ry DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci;2CREATE USER 'ry'@'localhost' IDENTIFIED BY 'password123';3GRANT ALL PRIVILEGES ON ry.* TO 'ry'@'localhost';4FLUSH PRIVILEGES;

3.2 导入初始数据

1. 找到项目中的SQL脚本（通常位于sql/ry_2023xxx.sql）。
2. 使用数据库工具执行脚本，或通过命令行导入：

   1mysql -u ry -p ry < ry_2023xxx.sql

验证：执行后检查是否生成了sys_user、sys_menu等系统表。

四、项目配置：修改关键参数

在运行前，需调整部分配置以匹配本地环境：

4.1 修改数据库连接

1. 打开ruoyi-admin/src/main/resources/application-druid.yml。
2. 修改以下参数（示例）：

   yaml1url: jdbc:mysql://localhost:3306/ry?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=false&serverTimezone=GMT%2B82username: ry3password: password123

4.2 调整Redis配置（可选）

若启用Redis缓存，需修改application.yml中的Redis地址和密码（默认未启用）。

4.3 修改日志路径

在application.yml中调整日志输出目录（如D:/logs/ruoyi），避免权限问题。

五、项目运行：启动后端服务

5.1 使用Maven启动（推荐）

1. 打开终端（或IDE的Terminal），进入项目根目录：

   1cd ruoyi

2. 执行Maven命令安装依赖并启动：

   1mvn clean install -DskipTests  # 跳过测试加速构建2cd ruoyi-admin3mvn spring-boot:run

提示：首次运行可能较慢（需下载依赖），后续启动会更快。

5.2 使用IDE启动（IntelliJ IDEA示例）

1. 打开项目根目录的pom.xml，IDEA会自动识别为Maven项目。
2. 等待依赖下载完成后，找到ruoyi-admin模块的启动类（RuoYiApplication.java）。
3. 右键选择「Run 'RuoYiApplication'」启动服务。

5.3 验证启动成功

• 控制台输出日志中查找以下内容：

  1Tomcat started on port(s): 8080 (http)2Started RuoYiApplication in X.XXX seconds

• 访问http://localhost:8080，若看到登录页面则成功。

六、前后端分离版本额外步骤（若依Vue）

若使用若依Vue版本，需额外配置前端项目：

6.1 拉取前端源码

1git clone https://gitee.com/y_project/RuoYi-Vue.git2cd RuoYi-Vue/ruoyi-ui

6.2 安装依赖并启动

1. 确保已安装Node.js 14+和npm/yarn。
2. 执行：

   1npm install       # 安装依赖2npm run dev       # 启动开发服务器

3. 访问http://localhost:81，前端会自动代理后端API。

七、常见问题解决

7.1 端口冲突

• 现象：启动时报Port 8080 was already in use。
• 解决：修改application.yml中的server.port为其他值（如8081）。

7.2 数据库连接失败

• 现象：Communications link failure或Access denied。
• 解决：
  • 检查MySQL服务是否运行。
  • 确认用户名、密码和数据库名是否正确。
  • 检查防火墙是否阻止了3306端口。

7.3 依赖下载失败

• 现象：Maven构建时卡在Downloading...。
• 解决：
  • 更换Maven镜像源（如阿里云镜像）。
  • 检查网络连接，或尝试关闭VPN。

7.4 登录页面空白

• 现象：访问http://localhost:8080后页面无内容。
• 解决：
  • 确认前端服务是否启动（若依Vue版本）。
  • 检查浏览器控制台是否有跨域错误（需配置CORS）。

八、总结与下一步建议

通过以上步骤，您已成功搭建若依框架的开发环境。接下来可以：

1. 探索功能：使用默认账号admin/admin123登录系统，熟悉后台模块。
2. 自定义开发：在ruoyi-system模块中添加业务逻辑，或创建新模块。
3. 学习文档：参考若依官方文档（GitHub Wiki）深入理解架构设计。
4. 参与社区：在Gitee/GitHub提交Issue或PR，与开发者交流。

若依框架的模块化设计和丰富功能能显著提升开发效率，但需注意：

• 定期备份数据库：避免测试数据丢失。
• 遵循代码规范：保持项目结构清晰。
• 关注版本更新：及时升级以获取新功能和安全补丁。

希望本文能帮助您快速上手若依框架，开启高效开发之旅！