恭喜你选择 RuoYi (若依) 框架作为切入点！它是目前国内 Java 生态中非常经典、流行且易于上手的后台管理框架。

这里默认你学习的是最主流的 前后端分离版本 (RuoYi-Vue)。如果你的环境（JDK, Maven, MySQL, Redis, Node.js）基本齐备，按以下步骤操作，通常 15-20分钟 就能跑通。

第一阶段：环境准备 (必做)

在开始之前，请确保你的电脑上已经安装并运行了以下软件。如果缺少任何一个，项目都跑不起来。

  1. JDK: 1.8 (推荐) 或 11/17 (取决于你下载的版本，默认 1.8 最稳)。
  2. MySQL: 5.7 或 8.0+ (记得你的 root 密码)。
  3. Redis: 必须安装并启动 (若依用它存 Token 和缓存，没它后端会报错)。
  4. Maven: 配置好阿里云镜像，否则下载依赖会很慢。
  5. Node.js: 前端运行环境 (建议 v14 或 v16，版本过高有时会有依赖兼容问题，但也通常可行)。

第二阶段：获取代码与数据库

1. 下载代码

去 Gitee (码云) 下载速度最快。

  • 地址：https://gitee.com/y_project/RuoYi-Vue
  • 你可以 git clone 或者直接下载 ZIP 包并解压。

2. 初始化数据库 (关键)

  1. 打开你的数据库管理工具 (Navicat / DBeaver)。
  2. 新建一个数据库，名字建议叫 ry-vue (字符集选 utf8mb4)。
  3. 在解压后的项目文件夹中找到 sql 目录，依次运行下面两个文件：
  • ry_20xx_xx_xx.sql (主结构数据)
  • quartz.sql (定时任务表)

注意： 一定要确保所有表都成功创建。

第三阶段：后端启动 (Backend)

  1. 导入项目： 打开 IntelliJ IDEA -> Open -> 选择解压后的文件夹 (根目录)。
  2. 等待依赖下载： 这是一个 Maven 多模块项目，右下角通常会提示 “Load Maven Project”，点击让它自动下载 Jar 包。
  3. 修改配置 (连接数据库)：
  • 找到 ruoyi-admin 模块 -> src/main/resources -> application-druid.yml。
  • 修改 URL： 确认端口是否是 3306，数据库名是否是你刚才建的 ry-vue。
  • 修改账号密码： 把 username 和 password 改成你本地 MySQL 的账号密码。
  1. 检查 Redis 配置：
  • 打开 application.yml，查看 Redis 配置 (通常默认是 localhost 和 6379，无密码)。如果你本地 Redis 有密码，记得在这里填上。
  1. 启动：
  • 找到 RuoYiApplication.java (在 ruoyi-admin 模块下)，右键 -> Run ‘RuoYiApplication’。
  • 观察控制台，如果看到 “若依启动成功” 的大字图案，说明后端通了！

第四阶段：前端启动 (Frontend)

  1. 进入前端目录：
  • 打开终端 (CMD 或 IDEA 的 Terminal)。
  • 进入 ruoyi-ui 目录：cd ruoyi-ui。
  1. 安装依赖：
  • 执行命令：npm install
  • 技巧：如果下载慢或报错，可以使用淘宝镜像： npm install --registry=https://registry.npmmirror.com
  1. 启动服务：
  • 执行命令：npm run dev
  1. 成功：
  • 启动完成后，浏览器通常会自动弹出，或者手动访问 http://localhost:80。

第五阶段：登录验证

如果不出意外，你应该能看到一个蓝色的登录界面。

  • 默认账号： admin
  • 默认密码： admin123
  • 验证码： 如果能看到验证码图片，说明后端 -> Redis -> 前端的链路是通的。如果验证码裂了，通常是 Redis 没开或者后端报错了。

常见“坑”与排雷指南

为了让你一次成功，请检查以下高频错误：

  • Error: Redis连接失败： 控制台疯狂报错 Connection refused。

  • 解法： 检查你本地的 Redis 服务有没有开启。Windows 上通常需要手动双击 redis-server.exe。

  • Error: 依赖下载失败 (Maven)： IDEA 里全是红线。

  • 解法： 刷新 Maven，或者检查 Maven 的 settings.xml 是否配置了阿里云镜像。

  • Error: 前端 node-sass 报错： npm install 出现一大堆 Python 相关的错误。

  • 解法： 通常是 Node 版本太高导致的。若依较新版本已换成 dart-sass 解决了此问题，但如果遇到，尝试降低 Node 版本到 v14，或者删除 node_modules 重新 npm install。

  • Error: 端口占用：

  • 后端默认用 8080，前端默认用 80。如果启动报错端口占用，去配置文件里改一下端口号即可。

下一步建议

既然跑通了，单纯看页面没有意义。建议你下一步做以下尝试来加深理解：

你想先从哪个方向入手？

  1. 代码生成器 (最核心功能)： 教你如何在数据库建一张表，然后一键生成所有的增删改查代码。
  2. 权限控制： 也就是它是怎么控制“谁能看哪个菜单”的 (Spring Security)。
  3. 项目结构分析： 搞清楚 common, framework, system 这些模块分别是干嘛的。

告诉我你的选择，我带你继续！