一、准备环境（必须先装）

JDK 17 配置好环境变量、Maven 3.6+ 配置阿里云镜像、Node.js 16~18 版本（不要太高）、MySQL 8.0+、RedisHBuilderX（用来跑移动端 UniApp）。

二、版本梳理

RuoYi框架（单体）：

RuoYi-Vue ，前后端分离标准版，后台+前端： git clone https://gitee.com/y_project/RuoYi-Vue.git

RuoYi-Vue3，Vue3 + TS 版本，匹配后台的前端： git clone https://gitcode.com/yangzongzhuan/RuoYi-Vue3.git

RuoYi‑Cloud框架（微服务）：

RuoYi‑Cloud： git clone https://gitee.com/zhangmrit/ruoyi-cloud.git

RuoYi‑Cloud‑Vue3，TypeScript：git clone https://gitcode.com/yangzongzhuan/RuoYi-Cloud-Vue3.git

RuoYi-App（移动端）：

RuoYi-App，实现了与RuoYi-Vue、RuoYi-Cloud完美对接的移动解决方案：git clone https://gitee.com/y_project/RuoYi-App.git

三、后端工程搭建

克隆代码： git clone https://gitee.com/y_project/RuoYi-Vue.git

软件：IDEA

导入数据库，sql目录下：  ry_2026xxxx.sql、quartz.sql

修改数据库上传文件存储路径、Redis的配置文件： ruoyi-admin/src/main/resources/application.yml

修改数据库MySQL配置： ruoyi-admin/src/main/resources/application-druid.yml

Maven依赖下载完成后启动：ruoyi-admin/src/main/java/com/ruoyi/RuoYiApplication

访问地址： http://localhost:8080/swagger-ui/index.html

四、PC前端Vue3工程搭建

克隆代码： git clone https://gitcode.com/yangzongzhuan/RuoYi-Vue3.git

软件：VSCode

进入目录：cd RuoYi-Vue3，安装依赖：npm install，开发环境启动：npm run dev

启动成功后默认地址：http://localhost，账号密码：admin/admin123。

五、移动端UniApp工程搭建

克隆代码： git clone https://gitee.com/y_project/RuoYi-App.git

软件：HBuilderX

导入RuoYi-App：HBuilderX => 文件 => 从本地目录导入

运行项目：HBuilderX => 文件 => 运行到浏览器