【特别推荐】RuoYi-Vue的安装与使用教程
项目地址: https://gitcode.com/yangzongzhuan/RuoYi-Vue 还在为搭建企业级管理系统而烦恼吗？RuoYi-Vue作为国内知名的开源快速开发平台，基于SpringBoot + Vue的前后端分离架构，提供了完整的权限管理解决方案。本文将手把手教你如何从零开始安装和使用RuoYi-Vue，让你快速构建专业的企业管理系统！
🎯 读完本文你将获得
- ✅ 完整的RuoYi-Vue环境搭建指南
- ✅ 前后端项目的启动与配置技巧
- ✅ 系统核心功能的使用方法
- ✅ 代码生成器的实战应用
- ✅ 常见问题排查与解决方案
📋 技术栈概览
RuoYi-Vue采用现代化的技术架构，具体技术选型如下：
| 技术领域 | 技术组件 | 版本 |
|---|---|---|
| 后端框架 | Spring Boot | 2.5.15 |
| 安全框架 | Spring Security + JWT | 5.7.12 |
| 前端框架 | Vue.js + Element UI | 2.6.12 + 2.15.14 |
| 数据库 | MySQL + Redis | 5.7+ |
| 构建工具 | Maven + Node.js | 3.6+ + 8.9+ |
🚀 环境准备与安装
1. 基础环境要求
在开始之前，请确保你的开发环境满足以下要求：
# Java环境
java -version # 需要JDK 1.8+
# Maven环境
mvn -version # 需要Maven 3.6+
# Node.js环境
node -v # 需要Node.js 8.9+
npm -v # 需要npm 6.0+
# MySQL数据库
mysql --version # 需要MySQL 5.7+
# Redis缓存
redis-server --version # 需要Redis 3.0+
2. 数据库初始化
首先创建数据库并导入初始化数据：
-- 创建数据库
CREATE DATABASE IF NOT EXISTS `ry-vue` DEFAULT CHARACTER SET utf8mb4;
-- 使用数据库
USE `ry-vue`;
-- 执行项目中的SQL脚本
-- 项目sql目录下的ry_20250522.sql和quartz.sql
3. 项目配置调整
根据你的环境修改配置文件：
# ruoyi-admin/src/main/resources/application.yml
spring:
datasource:
url: jdbc:mysql://localhost:3306/ry-vue?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
username: your_username
password: your_password
redis:
host: localhost
port: 6379
password: your_redis_password
🔥 项目启动与运行
后端服务启动
# 进入项目根目录
cd RuoYi-Vue
# 使用Maven编译项目
mvn clean package
# 启动后端服务
cd ruoyi-admin/target
java -jar ruoyi-admin.jar
# 或者使用Maven直接运行
mvn spring-boot:run
前端服务启动
# 进入前端目录
cd ruoyi-ui
# 安装依赖
npm install
# 启动开发服务器
npm run dev
# 构建生产版本
npm run build:prod
🎮 系统功能体验
1. 登录系统
启动成功后，访问 http://localhost:80（前端默认端口）即可看到登录界面：
| 账号 | 密码 | 角色权限 |
|---|---|---|
| admin | admin123 | 超级管理员 |
| ry | admin123 | 普通用户 |
2. 核心功能模块
RuoYi-Vue提供了丰富的功能模块：
3. 代码生成器使用
代码生成器是RuoYi-Vue的亮点功能，可以快速生成CRUD代码：
- 配置数据源：在系统工具 → 代码生成中配置数据库连接
- 导入表结构：选择需要生成代码的数据表
- 生成代码：设置生成选项并生成代码
- 下载使用：下载生成的代码并集成到项目中
示例生成配置：
// 生成的基本配置
public class GenConfig {
private String author = "若依"; // 作者
private String packageName = "com.ruoyi"; // 包名
private String moduleName; // 模块名
private String businessName; // 业务名
private String functionName; // 功能名
}
🛠️ 自定义开发指南
1. 添加新模块
要在RuoYi-Vue中添加新模块，遵循以下步骤：
2. 权限配置示例
// 在Controller中添加权限注解
@RestController
@RequestMapping("/system/newmodule")
public class NewModuleController {
@PreAuthorize("@ss.hasPermi('system:newmodule:list')")
@GetMapping("/list")
public TableDataInfo list(NewModule newModule) {
// 业务逻辑
}
@PreAuthorize("@ss.hasPermi('system:newmodule:add')")
@Log(title = "新模块", businessType = BusinessType.INSERT)
@PostMapping
public AjaxResult add(@RequestBody NewModule newModule) {
// 新增逻辑
}
}
🔧 常见问题解决
1. 端口冲突问题
如果8080端口被占用，可以修改配置：
# application.yml
server:
port: 8081 # 修改为其他端口
2. 数据库连接失败
检查数据库配置并确保服务正常运行：
# 检查MySQL服务
systemctl status mysql
# 检查Redis服务
systemctl status redis
3. 前端依赖安装失败
使用国内镜像源加速安装：
# 使用淘宝镜像
npm install -g cnpm --registry=https://registry.npmmirror.com
cnpm install
# 或者直接配置npm镜像
npm config set registry https://registry.npmmirror.com
📊 性能优化建议
1. 数据库优化
-- 为常用查询字段添加索引
CREATE INDEX idx_user_name ON sys_user(user_name);
CREATE INDEX idx_dept_parent ON sys_dept(parent_id);
2. Redis缓存配置
# 优化Redis连接池配置
spring:
redis:
lettuce:
pool:
max-active: 20 # 最大连接数
max-idle: 10 # 最大空闲连接
min-idle: 5 # 最小空闲连接
3. JVM参数调优
# 启动时添加JVM参数
java -Xms512m -Xmx1024m -XX:+UseG1GC -jar ruoyi-admin.jar
🎯 总结
通过本教程，你已经掌握了RuoYi-Vue的完整安装和使用流程。这个强大的开源项目不仅提供了完善的基础功能，还通过代码生成器等工具大大提升了开发效率。
关键收获：
- ✅ 掌握了前后端分离项目的环境搭建
- ✅ 理解了RuoYi-Vue的架构设计理念
- ✅ 学会了使用代码生成器快速开发
- ✅ 了解了系统权限管理的实现方式
- ✅ 获得了项目优化和问题排查的经验
RuoYi-Vue作为一个成熟的开源项目，非常适合作为企业级管理系统的开发基础。无论是学习SpringBoot和Vue的整合，还是快速开发实际项目，都是绝佳的选择。
现在就开始你的RuoYi-Vue之旅吧！如果在使用过程中遇到任何问题，欢迎在评论区交流讨论。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
