RuoYi-Vue-Plus 项目使用教程

2026-02-06 04:22:19作者：虞亚竹Luna

1. 项目的目录结构及介绍

RuoYi-Vue-Plus 是一个基于 Spring Boot 3.4 和 Vue3 的企业级快速开发平台，针对分布式集群与多租户场景进行了全方位升级。项目采用插件化+扩展包形式，结构解耦，易于扩展。

目录结构介绍

RuoYi-Vue-Plus/
├── ruoyi-admin/                 # 核心管理模块
│   ├── src/main/java/org/dromara/    # Java源码目录
│   │   ├── DromaraApplication.java   # 项目启动类
│   │   ├── web/controller/           # 控制器层
│   │   ├── web/service/              # 服务层
│   │   └── web/listener/             # 监听器
│   └── src/main/resources/           # 配置文件目录
│       ├── application.yml           # 主配置文件
│       ├── application-dev.yml       # 开发环境配置
│       ├── application-prod.yml      # 生产环境配置
│       ├── logback-plus.xml          # 日志配置
│       └── i18n/                     # 国际化文件
├── ruoyi-common/                 # 公共模块
│   ├── ruoyi-common-core/        # 核心工具类
│   ├── ruoyi-common-web/         # Web相关组件
│   ├── ruoyi-common-mybatis/     # Mybatis扩展
│   ├── ruoyi-common-redis/       # Redis组件
│   └── ...其他20+个公共子模块
├── ruoyi-modules/                # 业务模块
│   ├── ruoyi-system/             # 系统管理模块
│   ├── ruoyi-generator/          # 代码生成器
│   ├── ruoyi-demo/               # 示例模块
│   ├── ruoyi-job/                # 任务调度
│   └── ruoyi-workflow/           # 工作流
├── ruoyi-extend/                 # 扩展模块
│   ├── ruoyi-monitor-admin/      # 监控管理
│   └── ruoyi-snailjob-server/    # 分布式任务调度
└── script/                       # 脚本文件
    ├── docker/                   # Docker部署配置
    ├── sql/                      # 数据库脚本
    └── leave/                    # 示例数据

2. 项目的启动文件介绍

项目的启动文件是 ruoyi-admin/src/main/java/org/dromara/DromaraApplication.java，这是整个Spring Boot应用的入口点。

package org.dromara;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.context.metrics.buffering.BufferingApplicationStartup;

@SpringBootApplication
public class DromaraApplication {
    public static void main(String[] args) {
        SpringApplication application = new SpringApplication(DromaraApplication.class);
        application.setApplicationStartup(new BufferingApplicationStartup(2048));
        application.run(args);
        System.out.println("(♥◠‿◠)ﾉﾞ  RuoYi-Vue-Plus启动成功   ლ(´ڡ`ლ)ﾞ");
    }
}

启动类使用了 @SpringBootApplication 注解，包含了配置、自动配置和组件扫描功能。通过设置 BufferingApplicationStartup 来优化启动性能。

3. 项目的配置文件介绍

主配置文件 application.yml

项目的主要配置文件位于 ruoyi-admin/src/main/resources/application.yml，包含以下主要配置：

# 服务器配置
server:
  port: 8080
  servlet:
    context-path: /
  undertow:
    threads:
      io: 4
      worker: 32

# Spring配置
spring:
  application:
    name: ruoyi-vue-plus
  profiles:
    active: dev
  mvc:
    pathmatch:
      matching-strategy: ant_path_matcher

# Mybatis配置
mybatis-plus:
  mapper-locations: classpath*:mapper/**/*Mapper.xml
  type-aliases-package: org.dromara.**.domain
  configuration:
    map-underscore-to-camel-case: true
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

# 日志配置
logging:
  config: classpath:logback-plus.xml

开发环境配置 application-dev.yml

# 数据源配置
spring:
  datasource:
    dynamic:
      primary: master
      datasource:
        master:
          url: jdbc:mysql://localhost:3306/ry-vue-plus?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
          username: root
          password: password
          driver-class-name: com.mysql.cj.jdbc.Driver

# Redis配置
  data:
    redis:
      host: localhost
      port: 6379
      password: 
      database: 0

# 文件上传配置
  servlet:
    multipart:
      max-file-size: 10MB
      max-request-size: 100MB