maven详解

        Maven 是一个广泛使用的自动化构建工具，主要用于 Java 项目的构建、依赖管理和项目信息管理。它由 Apache 软件基金会维护，旨在简化 Java 项目的开发流程，提高开发效率，并促进团队协作。Maven 的核心是 项目对象模型（Project Object Model, POM）。POM 是一个 XML 文件（pom.xml），用于描述项目的结构、依赖、插件配置等。每个 Maven 项目都有一个唯一的 pom.xml 文件，它定义了项目的元数据，如项目名称、版本、开发者信息等。

一.Maven的核心概念说明

1.1.Maven 的核心功能

• 依赖管理：自动下载和管理项目所需的第三方库（JAR 文件）。
• 生命周期管理：提供标准化的构建流程，包括编译、测试、打包、部署等阶段。
• 插件管理：通过插件扩展 Maven 的功能，支持各种构建任务，如代码生成、文档生成、测试等。
• 项目结构管理：提供标准化的目录结构，使项目结构清晰、易于维护。

1.2. Maven 的生命周期

Maven 的三个标准生命周期，这三套生命周期完全独立，互补影响，下面是详细解释。

• default：用于构建项目，包括编译、测试、打包、安装和部署等
  • validate：验证项目配置。
  • initialize：初始化构建环境。
  • generate-sources：生成源代码。
  • process-sources：处理源代码。
  • generate-resources：生成资源文件。
  • process-resources：处理资源文件。
  • compile：编译源代码。
  • test-compile：编译测试代码。
  • test：运行单元测试。
  • package：打包项目。
  • install：将打包后的项目安装到本地仓库。
  • deploy：将项目部署到远程仓库。
• clean：用于清理项目，删除上一次构建生成的文件。
  • pre-clean：执行一些清理前需要完成的工作。
  • clean：清理上一次构建生成的文件（默认删除 target 目录）。
  • post-clean：执行一些清理后需要完成的工作
• site：用于生成项目站点文档。
  • pre-site：执行一些生成站点前需要完成的工作。
  • site：生成项目站点文档。
  • post-site：执行一些生成站点后需要完成的工作。
  • site-deploy：将生成的站点文档部署到远程服务器。

1.3. Maven 的插件系统

        Maven 的插件系统是其强大的功能之一，在 Maven 的构建体系中，插件（Plugin）是实现各种构建任务的核心机制。每个插件可以包含一个或多个目标（Goal），而这些目标又可以绑定到Maven 生命周期的某个阶段上，从而实现自动化构建、测试、打包、部署等功能。Maven 有三个标准生命周期：default、clean 和 site，它们各自包含一系列预定义的阶段（Phase）。插件的目标可以通过 <executions> 配置绑定到这些阶段上，控制其执行时机。下面列出了一个常用的插件。

插件的使用方式如下：

mvn [plugin-name]:[goal-name]

1.4. Maven 的仓库管理

Maven 使用 仓库 来存储和检索项目依赖。Maven 有以下几种类型的仓库：

• 本地仓库：存储项目依赖的本地目录，通常位于 \~/.m2/repository。
• 远程仓库：如 Maven Central，存储公共的 JAR 文件。
• 私有仓库：公司内部的 JAR 文件仓库，可以通过 Nexus 或 Artifactory 等工具管理。

Maven 的 settings.xml 文件可以配置仓库地址，例如：

<!--项目级别配置pom.xml，通常不推荐使用，除非有特别需求
定义项目所需的远程仓库地址（覆盖或补充默认仓库）-->
<repositories>
    <repository>
        <id>central</id>
        <url>https://repo.maven.apache.org/maven2</url>
    </repository>
</repositories>

<!--全局配置，settings.xml -->
<mirror>
      <id>alimaven</id>
      <mirrorOf>central</mirrorOf>
      <name>aliyun maven</name>
      <url>http://maven.aliyun.com/nexus/content/repositories/central/</url>
</mirror>

1.5. Maven 的高级功能

Maven 提供了多种高级功能，帮助开发者更高效地管理项目：

• 聚合（Aggregation） ：将多个子项目合并为一个父项目，统一管理。

<!-- 父项目pom.xml -->
<project>
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>xman-parent</artifactId>
    <version>1.0.0</version>
    <packaging>pom</packaging>  <!-- 聚合：必须为pom类型 -->
    
    <modules>
        <module>ruoyi-business</module>  <!-- 子模块1 -->
        <module>ruoyi-common</module>    <!-- 子模块2 -->
    </modules>
</project>

• 继承（Inheritance） ：子项目继承父项目的配置，减少重复配置。

<!-- 子模块ruoyi-business/pom.xml -->
<project>
<!-- 父模块 -->
    <parent>
        <groupId>com.example</groupId>
        <artifactId>xman-parent</artifactId>
        <version>1.0.0</version>
    </parent>
    
    <artifactId>ruoyi-business</artifactId>
    
    <!-- 自动继承父POM的依赖/插件配置 -->
    <dependencies>
        <!-- 子模块特有依赖 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <!-- 版本由父POM的dependencyManagement控制 -->
        </dependency>
    </dependencies>
</project>

• 依赖冲突解决：当多个依赖版本冲突时，Maven 会根据优先级规则（如 First Declaration Principle 或 Path Nearest Principle）选择合适的依赖。
• 插件配置：在 pom.xml 中详细配置插件，支持自定义插件目标和执行顺序。

1.6. Maven 的优势与局限性

Maven 的优势包括：

• 标准化的项目结构：简化了项目管理，提高了团队协作效率。
• 强大的依赖管理：自动下载和管理依赖，减少手动配置。
• 插件系统：支持丰富的插件，扩展性强。
• 生命周期管理：提供标准化的构建流程，提高开发效率。

Maven 的局限性包括：

• 学习曲线：对于新手来说，需要一定时间学习和掌握。
• 配置复杂：虽然默认配置简单，但高级功能需要详细配置。
• 版本冲突：在某些情况下，依赖冲突可能影响项目稳定性。

二.

二. Maven 的项目结构

Maven 项目通常遵循以下标准目录结构：

• src/main/java：存放主源代码。
• src/test/java：存放测试代码。
• src/main/resources：存放资源文件（如配置文件、图片等）。
• src/test/resources：存放测试资源文件。
• target：存放构建输出（如编译后的类文件、打包后的 JAR/WAR 文件）。
• pom.xml：项目配置文件，定义项目依赖、插件、生命周期等。

三.Maven 的依赖管理

Maven 通过 pom.xml 文件中的 <dependencies> 标签管理项目依赖。开发者只需声明所需的依赖项，Maven 会自动从远程仓库（如 Maven Central）下载所需的 JAR 文件。例如：

<dependencies>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.32</version>
    </dependency>
</dependencies>

四.Maven依赖的版本管理 

Maven 支持依赖的版本管理，可以通过 <dependencyManagement> 标签锁定依赖版本，确保项目的一致性。

1.父模块POM配置

<!-- 父项目pom.xml -->
<project>
    <!-- ... 父项目锁定版本 ... -->
    
    <dependencyManagement>
        <dependencies>
            <!-- Spring Boot Starter 全家桶 -->
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
                <version>3.4.2</version>
            </dependency>
            
            <!-- MyBatis Plus -->
            <dependency>
                <groupId>com.baomidou</groupId>
                <artifactId>mybatis-plus-boot-starter</artifactId>
                <version>3.5.10</version>
            </dependency>
            
            <!-- 第三方工具 -->
            <dependency>
                <groupId>com.alibaba</groupId>
                <artifactId>easyexcel</artifactId>
                <version>3.3.2</version>
            </dependency>
        </dependencies>
    </dependencyManagement>
</project>

2.子模块引用(无需版本)

<!-- 子模块pom.xml -->
<dependencies>
    <!-- 自动继承父POM中定义的版本 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    
    <!-- 可覆盖父POM的版本（不推荐） -->
    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-boot-starter</artifactId>
        <version>3.4.0</version> <!-- 特殊版本需求时使用 -->
    </dependency>
</dependencies>

3.版本变量集中管理

<properties>
    <spring-boot.version>3.4.2</spring-boot.version>
    <mybatis-plus.version>3.5.10</mybatis-plus.version>
</properties>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <version>${spring-boot.version}</version>
        </dependency>
    </dependencies>
</dependencyManagement>

4. BOM导入（推荐)

导入Spring Boot BOM必须用<dependencyManagement>

<!-- 直接导入Spring Boot官方BOM -->
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>3.4.2</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

5.效果对比

五.maven命令介绍

1.核心生命周期命令

• mvn clean：删除target目录（清理编译产物）。
• mvn compile：编译主代码（生成target/classes）。
• mvn test：运行单元测试（需src/test/java有测试类）。
• mvn package：打包（生成jar/war到target/）。
• mvn install：安装到本地仓库（供其他模块依赖）。
• mvn deploy：部署到远程仓库（需配置distributionManagement）。

2. 多模块操作

• -pl（指定模块）

  mvn -pl web-admin clean install  # 仅对web-admin模块执行clean和install 

• -am（连带依赖模块）

  mvn -am -pl web-admin install    # 处理web-admin及其依赖模块

• -rf（从指定模块继续执行）

  mvn -rf web-common compile       # 从web-common模块开始编译

3. 参数详解

• -D（定义系统属性）

  mvn test -Dtest=MyTestClass        # 运行指定测试类
  mvn install -DskipTests            # 跳过测试

• -P（激活Profile）

  mvn test -Dtest=MyTestClass        # 运行指定测试类
  mvn install -DskipTests            # 跳过测试

• -U（强制更新依赖）

  mvn clean install -U               # 强制更新远程仓库索引

4. 依赖与插件管理

• 依赖树分析

  mvn dependency:tree -Dverbose      # 显示完整的依赖树（含冲突）

• 插件目标查询

  mvn help:describe -Dplugin=org.apache.maven.plugins:maven-compiler-plugin -Ddetail

5. 常见组合命令

• 清理并重新构建

   mvn clean package -DskipTests

• 仅部署指定模块

   mvn -pl web-admin deploy

• 多模块并行构建

   mvn -T 4 clean install            # 使用4线程并行构建

6.注意事项

• 模块路径：需在项目根目录（含pom.xml）执行命令。
• 参数顺序：-D参数通常放在命令末尾。
• 环境隔离：通过-P切换不同环境的配置（如dev/prod）。
• 如果需要更具体的场景示例或某个命令的深入解释，可以进一步说明！