芋道管理系统学习——简介

前言

• 后端项目 ：ruoyi-vue-pro

  https://gitee.com/zhijiantianya/ruoyi-vue-pro

• 前端项目 ：yudao-ui-admin-vue3

  https://gitee.com/yudaocode/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 解压目录中执行：

.\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 安装依赖并启动

# 安装 pnpm，提升依赖的安装速度
npm config set registry https://registry.npmmirror.com
npm install -g pnpm
# 安装依赖
pnpm install

# 启动服务
npm run dev

3. pnpm 命令不可用问题说明

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
• 前后端启动完成后即可进行完整功能开发与调试