5分钟快速开始 RuoYi-Vue-Pro

基于 Spring Boot 和 Vue 的全功能后台管理系统,快速部署并体验核心功能。

环境要求

支持的操作系统

macOS Windows Linux

运行环境

JDK 8 或 17/21 必需
Node.js 16+ 必需
MySQL 5.7+ 必需
Redis 5.0+ 必需

所需工具

Git

克隆项目代码

必需
Maven

构建 Java 后端

必需
npm 或 yarn

构建 Vue 前端

必需

操作步骤

1

克隆项目并准备数据库

下载代码并导入初始 SQL 到 MySQL。

克隆项目到本地
git clone https://github.com/YunaiV/ruoyi-vue-pro.git
进入项目目录
cd ruoyi-vue-pro
导入数据库脚本,按提示输入密码
mysql -u root -p < sql/ruoyi-vue-pro.sql

预期结果::SQL 导入成功,无错误信息。

确保 MySQL 服务已启动,数据库名默认为 ruoyi-vue-pro。

2

配置后端环境

修改配置文件以连接 MySQL 和 Redis。

如果不在项目根目录,先进入
cd ruoyi-vue-pro
编辑开发环境配置,或使用其他编辑器
nano ruoyi-module-system/src/main/resources/application-dev.yml

预期结果::文件打开后,找到并修改数据库和 Redis 连接信息。

主要修改 spring.datasource.url、username、password 和 spring.redis.host、port。

3

启动后端服务

使用 Maven 编译并运行 Spring Boot 应用。

编译项目,跳过测试
mvn clean install -DskipTests
启动系统模块
mvn spring-boot:run -pl ruoyi-module-system

预期结果::看到 'Started Application in ... seconds' 表示启动成功。

默认端口为 8080,确保端口未被占用。

4

启动前端管理后台

构建并运行 Vue 前端(以 Vue3 + element-plus 为例)。

进入前端项目目录
cd yudao-ui-admin-vue3
安装依赖
npm install
启动开发服务器
npm run dev

预期结果::服务器启动,输出本地访问地址如 http://localhost:80。

如果使用其他前端版本,替换目录名和命令。

验证成功运行

访问前端界面并登录系统。

后端控制台无错误日志
前端页面正常加载
使用默认账号 admin/admin123 登录成功

快速提示

版本选择

使用 JDK 8 选择 master 分支,JDK 17/21 选择 master-jdk17 分支。

配置

如果遇到端口冲突,修改 application-dev.yml 中的 server.port。

前端

前端依赖安装慢可尝试使用 yarn 或设置淘宝镜像。

常见问题

1

数据库连接失败

检查 MySQL 服务状态和配置文件中的连接信息。

2

Redis 连接超时

确保 Redis 已启动,并检查配置中的 host 和 port。

3

前端 npm install 报错

清除 node_modules 后重试,或升级 Node.js 版本。

下一步

探索完整功能

登录后查看用户管理、角色权限等工作流模块。

阅读详细文档

访问项目 README 或启动文档了解更多配置和扩展。

尝试代码生成器

使用内置工具快速生成业务代码,加速开发。

助手