第一步：环境准备

• JDK：版本要求 >= 1.8 (推荐 1.8)。

• MySQL：版本要求 >= 5.7.0 (推荐 5.7)。

• Maven：版本要求 >= 3.0，用于管理项目依赖和构建。

• Git (可选)：用于从代码仓库克隆项目。

• Redis：版本要求 >= 3.0，作为缓存中间件。

• IDE (集成开发环境)：推荐使用 IntelliJ IDEA (社区版即可) 或 Eclipse。

第二步：克隆代码

• 主仓库：https://gitee.com/y_project/RuoYi（直接在 Gitee 页面上下载项目的 ZIP 压缩包并解压）

• 

第三步：配置数据库

创建数据库：使用 MySQL 客户端（如 Navicat）创建一个新的数据库，数据库名可以自定义，但在后面的配置中需要与之保持一致。（红线内容是数据库名）

导入数据：在项目根目录下找到 /sql/ 文件夹，里面有两个 SQL 文件：ry_2021xxxx.sql (或类似名称的核心表结构) 和 quartz.sql (定时任务相关表)。在你的数据库中依次执行这两个脚本，以初始化所需的数据表

第四步：配置项目与运行

1.修改配置文件：

• 打开项目下的配置文件：ruoyi-admin/src/main/resources/application-druid.yml。

• 在此文件中，将数据库连接配置 (url, username, password) 修改为你自己刚才创建的数据库信息。

2.配置Maven和JDK

• 确认 IDEA 中 Maven 的设置（仓库路径等）是否正确。

• 确认项目使用的 JDK 版本为 1.8

3.启动Redis

确保 Redis 服务已经在本地启动并运行，否则项目启动时会报错

4.启动后端项目

• 找到项目启动入口类 RuoYiApplication.java (位于 ruoyi-admin 模块下)。

• 右键点击该类，选择 Run 'RuoYiApplication.main()' 来启动后端服务。

• 当控制台看到类似 Started RuoYiApplication in X seconds 的日志时，就表示启动成功了。

• 浏览器上访问 http://localhost:8080

第五步：运行前端

1.安装/检查Node.js（最好是16.x，也可用其他版本以便后续开发）

下载：Index of /download/release/latest-v16.x/
选择 node-v16.20.2-x64.msi（64位系统）

在终端输入 node-v 查看版本

安装时关键一步：
在安装选项中，确保勾选 "Add to PATH"，这样会自动配置环境变量

2.安装依赖启动项目（在IDEA终端）

1.安装依赖
npm install

npm install

2.启动
npm run dev

npm run dev

如果版本正确但运行出错（依赖包可能是用高版本 Node.js 安装的）需要清理重装：

1. 删除 node_modules 文件夹
Remove-Item -Recurse -Force node_modules

Remove-Item -Recurse -Force node_modules

2. 删除 package-lock.json
Remove-Item -Force package-lock.json

Remove-Item -Force package-lock.json

 3.清理 npm 缓存
npm cache clean --force

npm cache clean --force

 4.重新安装依赖
npm install

npm install

5.重新启动
npm run dev

npm run dev

第六步：访问验证

• 前端访问地址：http://localhost

• 默认登录名：admin

• 默认密码：admin123

如果没有验证码检查后端是否启动