【亲测免费】 若依（RuoYi）项目使用教程

1. 项目目录结构及介绍

若依项目的目录结构如下：

RuoYi/
├── .github/              # GitHub相关文件
├── bin/                  # 执行脚本
├── doc/                  # 项目文档
├── ruoyi-admin/          # 后台管理模块
├── ruoyi-common/         # 公共模块，包括工具类、实体类等
├── ruoyi-framework/      # 框架核心模块，包括配置类、拦截器等
├── ruoyi-generator/      # 代码生成模块
├── ruoyi-quartz/         # 定时任务模块
├── ruoyi-system/         # 系统模块，包括用户、角色、菜单等管理
├── sql/                  # SQL脚本
├── .gitignore            # Git忽略文件
├── LICENSE              # 许可证文件
├── README.md            # 项目说明文件
├── pom.xml              # Maven项目配置文件
└── ry.bat, ry.sh         # 项目启动脚本

• .github/: 存放与GitHub相关的文件。
• bin/: 包含项目的启动脚本。
• doc/: 存放项目文档资料。
• ruoyi-admin/: 后台管理模块，提供后台管理界面。
• ruoyi-common/: 公共模块，提供一些通用的工具类和基础实体类。
• ruoyi-framework/: 框架核心模块，包含项目的基础配置、拦截器、异常处理器等。
• ruoyi-generator/: 代码生成模块，用于生成实体类、接口、XML映射等。
• ruoyi-quartz/: 定时任务模块，用于管理定时任务。
• ruoyi-system/: 系统模块，包括用户管理、角色管理、菜单管理等。
• sql/: 存放项目所需的SQL脚本。
• .gitignore: 指定Git忽略的文件。
• LICENSE: 项目的许可证文件。
• README.md: 项目说明文件。
• pom.xml: Maven项目的配置文件。
• ry.bat 和 ry.sh: 分别是Windows和Linux下的项目启动脚本。

2. 项目的启动文件介绍

项目的启动脚本位于bin/目录下，包括：

• ry.bat: Windows系统下的启动批处理文件。
• ry.sh: Linux或Mac系统下的启动脚本。

运行这些脚本会启动Maven命令来运行项目，通常情况下，你可以直接使用这些脚本来启动项目。

# Windows下启动
.\bin\ry.bat

# Linux或Mac下启动
./bin/ry.sh

3. 项目的配置文件介绍

项目的配置文件主要位于ruoyi-admin/src/main/resources目录下，主要包括以下文件：

• application.yml: Spring Boot应用程序的基础配置文件，可以配置数据库连接、服务器端口、日志等。
• bootstrap.yml: 在应用程序上下文创建之前，Spring Boot会加载这个文件，适用于一些早期配置，如数据库配置等。
• application-prod.yml: 生产环境下的配置文件，通常包含与生产相关的特定配置。
• application-dev.yml: 开发环境下的配置文件，包含开发环境的特定配置。

在application.yml文件中，常见的配置项包括：

server:
  port: 8080   # 服务端口
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/ruoyi?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=false&serverTimezone=GMT%2B8
    username: root   # 数据库用户名
    password: 123456 # 数据库密码
    driver-class-name: com.mysql.cj.jdbc.Driver # 数据库驱动

确保根据实际情况修改数据库配置等敏感信息。