利用ruoyi快速开发
第一章:部署与搭建若依(RuoYi)开发环境
在开始开发若依项目之前,我们需要先搭建好完整的开发环境,包括后端、前端以及数据库等依赖。下面将从环境准备、项目下载、数据库配置、后端启动到前端启动逐步讲解。
一、环境准备
若依项目依赖以下软件和工具,请确保提前安装:
- Java:建议安装 Java 17(或项目所需版本)。
- MySQL:用于存储项目数据。
- Node.js 和 npm:前端依赖管理和运行。npm 用于管理前端包。
- Redis:可选,若项目涉及缓存功能。
- Maven:后端依赖管理工具。
- Git:用于克隆项目代码。
- IDE(如 IntelliJ IDEA 或 Eclipse):用于打开和编辑后端代码。
二、下载项目
- 打开终端或命令行工具。
- 使用 Git 克隆若依项目代码到本地:
git clone https://gitee.com/y_project/RuoYi-Vue.git
- 克隆完成后,本地将生成
RuoYi-Vue
项目目录,包括前端ruoyi-ui
和后端ruoyi-admin
等模块。
三、打开项目并准备依赖
-
使用 IDE 打开项目根目录
RuoYi-Vue
。 -
项目目录结构概览:
ruoyi-admin
:后端 Java 项目ruoyi-ui
:前端 Vue 项目ruoyi-system
等子模块:包含数据库映射和核心逻辑
-
配置前端依赖:
- 打开命令行进入
ruoyi-ui
目录。 - 执行以下命令安装项目依赖:
- 打开命令行进入
npm install
# 如果 npm 下载速度慢,可使用镜像:
npm install --registry=https://registry.npmmirror.com
四、配置数据库
- 打开 MySQL,在本地创建数据库:
CREATE DATABASE ruoyi DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
-
导入项目提供的 SQL 文件:
ry.sql
:包含基础表结构和初始化数据quartz.sql
:包含定时任务表(可选)
可以在 MySQL 客户端或 IDE 的数据库工具中依次执行以上 SQL 文件。
-
配置数据库连接信息:
- 打开
ruoyi-admin/src/main/resources/application-druid.yml
文件 - 修改以下信息为本地数据库配置:
- 打开
spring:datasource:url: jdbc:mysql://localhost:3306/ruoyi?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghaiusername: rootpassword: 你的数据库密码
五、配置日志
- 打开
ruoyi-admin/src/main/resources/logback.xml
文件 - 修改日志输出路径,将日志保存到本地指定目录,例如:
<property name="log.path" value="F:/class/RuoYi-Vue/logs" />
- 日志配置完成后,可以更方便地查看系统运行信息和错误。
六、启动后端程序
- 在 IDE 中找到
RuoYiApplication.java
:
ruoyi-admin/src/main/java/com/ruoyi/RuoYiApplication.java
- 右键运行或使用 IDE 的运行按钮启动程序。
- 程序启动成功后,你会在控制台看到若依的图案输出,表示后端启动正常。
七、启动前端程序
- 打开命令行工具,进入前端目录:
cd ruoyi-ui
- 启动前端开发服务器:
npm run dev
- 等待前端编译完成后,浏览器访问
http://localhost:80
,即可看到若依系统完整页面。
至此,若依项目的前后端环境已经搭建完成。