前言
-
后端项目 ：
ruoyi-vue-pro -
前端项目 ：
yudao-ui-admin-vue3
本文记录 RuoYi-Vue-Pro（Yudao） 前后端项目在本地环境的完整启动过程，适用于初次搭建开发环境的同学。
项目启动
一、后端项目启动
1. 克隆代码
- 从 Gitee 克隆
ruoyi-vue-pro项目 - 使用 IntelliJ IDEA 打开项目
- 修改项目配置：
- JDK 版本：Java 8
- Maven：配置为本地 Maven 路径
2. 初始化 MySQL
后端默认使用 MySQL（也支持其他数据库）。
2.1 创建数据库
创建名为 ruoyi-vue-pro 的数据库。
2.2 导入初始化脚本
执行项目 sql 目录下的 ruoyi-vue-pro.sql
2.3 修改数据库配置
在 yudao-server 模块中，修改数据库连接信息为自己的账号和密码：
3. 初始化 Redis
3.1 启动 Redis
在 Redis 解压目录中执行：
bash
.\redis-server.exe redis.windows.conf默认启动端口为 6379，无账号密码。
3.2 修改 Redis 配置
在 yudao-server 模块中配置 Redis 连接信息：
4. 启动后端服务
4.1 编译项目
使用 IDEA 编译项目：
4.2 启动项目
执行 YudaoServerApplication 类
启动完成后，使用浏览器访问 http://127.0.0.1:48080地址，返回如下 JSON 字符串，说明成功。
二、前端项目启动
1. 前端项目说明
yudao-ui-admin-vue3：基于 Vue3 + element-plus
yudao-ui-admin-vben ：基于 Vue3 + vben5.0(ant-design-vue)
yudao-ui-admin-vue2：基于 Vue2 + element-ui
yudao-ui-admin-uniapp：基于 Vue3 + uni-app
2. 克隆并安装依赖
2.1 克隆项目
将前端项目克隆到本地。
2.2 安装依赖并启动
bash
# 安装 pnpm，提升依赖的安装速度
npm config set registry https://registry.npmmirror.com
npm install -g pnpm
# 安装依赖
pnpm install
# 启动服务
npm run dev3. pnpm 命令不可用问题说明
bash
npm install -g pnpm >> changed 1 package in 2s 1 package is looking for funding run npm fund for details
pnpm -v >> pnpm : 无法将"pnpm"项识别为 cmdlet、函数、脚本文件或可运行 程序的名称。请检查名称的拼写，如果包括路径，请确保路径正确， 然后再试一次。 所在位置 行:1 字符: 1 + pnpm -v + ~~~~ + CategoryInfo : ObjectNotFound: (pnpm:String) [], CommandNotFoundException + FullyQualifiedErrorId : CommandNotFoundException问题原因
👉 pnpm 已经安装成功，但 npm 的全局 bin 目录未加入 PATH 环境变量
解决方案
处理过程参考文章：
pnpm 已经安装成功，但 npm 的全局 bin 目录没有进 PATH
4. 访问前端页面
启动完成后，浏览器会自动打开：http://localhost:80
⚠️ 建议修改前端端口 ：
80 端口为特权端口，Windows 普通用户无权监听，容易出现权限问题。
总结
- 后端基于 ruoyi-vue-pro（Yudao）
- 前端基于 Vue3 + Element Plus
- 依赖 MySQL + Redis
- 前后端启动完成后即可进行完整功能开发与调试