Maven：详细学习笔记

小马爱打代码2025-11-13 11:57

第1章：引言

1.1 什么是Maven？

Apache Maven是一个强大的项目管理和构建自动化工具，主要服务于基于Java平台的项目构建、依赖管理和项目信息管理。它使用一个中央信息片段（POM文件）来管理项目的构建、报告和文档。

1.2 Maven的核心价值

依赖管理：自动下载和管理项目依赖

标准化构建：统一的构建流程和目录结构

插件架构：丰富的插件生态系统

项目信息管理：集中管理项目信息

多模块支持：支持大型项目的模块化管理

1.3 Maven的历史与发展

2001年：Maven 1.0发布，基于Ant

2004年：Maven 2.0发布，重写架构

2009年：Maven 3.0发布，性能大幅提升

2010年至今：持续更新和维护

1.4 Maven的优势

约定优于配置：提供标准的项目结构

依赖自动解析：自动下载和管理依赖

统一的项目信息：POM文件集中管理

丰富的插件：覆盖各种构建需求

跨平台支持：支持多种操作系统

1.5 Maven与Gradle对比

第2章：Maven基础概念

2.1 核心组件
POM（Project Object Model）

POM是Maven项目的核心，XML格式的配置文件，定义了项目的：

坐标信息（groupId、artifactId、version）

依赖关系

构建配置

项目信息

坐标系统

Maven使用坐标来唯一标识一个项目：

groupId：组织或项目的唯一标识符

artifactId：项目或模块的名称

version：项目的版本号

packaging：打包方式（jar、war、pom等）

仓库系统

Maven有三种类型的仓库：

本地仓库：存储在本地机器上

中央仓库：Maven官方仓库

远程仓库：第三方仓库（如阿里云镜像）

2.2 构建生命周期

Maven的构建生命周期分为三个主要阶段：

Clean Lifecycle（清理生命周期）

pre-clean

clean：删除target目录

post-clean

Default Lifecycle（默认生命周期）

validate：验证项目结构

compile：编译源代码

test：运行测试

package：打包

verify：验证包

install：安装到本地仓库

deploy：部署到远程仓库

Site Lifecycle（站点生命周期）

pre-site

site：生成项目站点

post-site

site-deploy

2.3 依赖范围

Maven定义了六种依赖范围：

compile：编译、测试、运行时都需要

test：仅测试时需要

provided：编译和测试时需要，运行时由容器提供

runtime：运行时需要，编译时不需要

system：系统范围，需要指定系统路径

import：仅用于依赖管理

2.4 插件系统

Maven的插件分为两类：

Build plugins：在构建过程中执行

Reporting plugins：生成报告

第3章：安装与配置

3.1 系统要求

JDK 1.7或更高版本

支持的操作系统：Windows、macOS、Linux

3.2 下载安装
Windows安装

java 复制代码 
下载apache-maven-x.x.x-bin.zip
解压到指定目录（如C:\apache-maven-x.x.x）
配置环境变量：
MAVEN_HOME = C:\apache-maven-x.x.x
PATH 添加 %MAVEN_HOME%\bin
验证安装：mvn -v

Linux安装

java 复制代码 
# 下载
wget https://downloads.apache.org/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.tar.gz

# 解压
tar -xzf apache-maven-3.8.6-bin.tar.gz
sudo mv apache-maven-3.8.6 /opt/

# 配置环境变量
export MAVEN_HOME=/opt/apache-maven-3.8.6
export PATH=$PATH:$MAVEN_HOME/bin

# 验证安装
mvn -v
macOS安装
# 使用Homebrew
brew install maven

# 或手动安装
curl -O https://downloads.apache.org/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.tar.gz
tar -xzf apache-maven-3.8.6-bin.tar.gz
sudo mv apache-maven-3.8.6 /usr/local/

# 配置环境变量
export MAVEN_HOME=/usr/local/apache-maven-3.8.6
export PATH=$PATH:$MAVEN_HOME/bin

3.3 配置设置
settings.xml位置

java 复制代码 
全局配置：${MAVEN_HOME}/conf/settings.xml
用户配置：${USER_HOME}/.m2/settings.xml

基本配置

java 复制代码 
<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
    <localRepository>${user.home}/.m2/repository</localRepository>

    <mirrors>
        <mirror>
            <id>aliyun</id>
            <mirrorOf>*</mirrorOf>
            <url>https://maven.aliyun.com/repository/public</url>
        </mirror>
    </mirrors>

    <profiles>
        <profile>
            <id>jdk-11</id>
            <activation>
                <activeByDefault>true</activeByDefault>
                <jdk>11</jdk>
            </activation>
            <properties>
                <maven.compiler.source>11</maven.compiler.source>
                <maven.compiler.target>11</maven.compiler.target>
            </properties>
        </profile>
    </profiles>
</settings>

3.4 IDE集成
IntelliJ IDEA

默认支持Maven项目

自动导入Maven项目

提供Maven工具窗口

Eclipse

内置Maven支持

Maven项目向导

依赖可视化

VS Code

需要安装Maven扩展

支持Maven命令执行

提供项目视图

第4章：项目结构

4.1 标准目录结构

java 复制代码 
project/
├── pom.xml                    # 项目描述文件
├── src/
│   ├── main/                  # 主代码目录
│   │   ├── java/              # Java源代码
│   │   ├── resources/         # 资源文件
│   │   ├── filters/           # 资源过滤文件
│   │   └── webapp/            # Web应用文件
│   └── test/                  # 测试代码目录
│       ├── java/              # 测试源代码
│       └── resources/         # 测试资源文件
├── target/                    # 构建输出目录
├── .mvn/                      # Maven包装器
└── mvnw/mvnw.cmd             # Maven包装器脚本

4.2 自定义目录结构

java 复制代码 
<build>
    <sourceDirectory>src/main/java</sourceDirectory>
    <testSourceDirectory>src/test/java</testSourceDirectory>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
        </resource>
    </resources>
    <testResources>
        <testResource>
            <directory>src/test/resources</directory>
        </testResource>
    </testResources>
    <directory>target</directory>
    <outputDirectory>target/classes</outputDirectory>
    <testOutputDirectory>target/test-classes</testOutputDirectory>
</build>

4.3 Maven Wrapper

Maven Wrapper提供：

自动下载指定版本的Maven

确保团队使用一致的Maven版本

无需手动安装Maven

java 复制代码 
# 生成Wrapper
mvn wrapper:wrapper

# 使用Wrapper
./mvnw clean compile  # Linux/macOS
mvnw.cmd clean compile  # Windows

4.4 构建产物目录

java 复制代码 
target/
├── classes/               # 编译后的class文件
├── test-classes/          # 测试编译文件
├── maven-archiver/        # Maven归档器文件
├── surefire-reports/      # 测试报告
├── site/                  # 生成的站点
├── dependency/            # 依赖信息
├── generated-sources/     # 生成的源代码
└── project-name-version.jar  # 构建产物

第5章：POM文件详解

5.1 POM文件结构

java 复制代码 
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
                             http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <!-- 基本信息 -->
    <groupId>com.example</groupId>
    <artifactId>my-app</artifactId>
    <version>1.0.0</version>
    <packaging>jar</packaging>

    <!-- 项目信息 -->
    <name>My Application</name>
    <description>A sample Maven project</description>
    <url>https://example.com</url>

    <!-- 属性 -->
    <properties>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <!-- 依赖管理 -->
    <dependencies>
        <!-- 具体依赖 -->
    </dependencies>

    <!-- 构建配置 -->
    <build>
        <!-- 插件管理 -->
    </build>
</project>

5.2 坐标信息
groupId

组织或项目的唯一标识符

通常使用反向域名命名

例如：com.example、org.apache

artifactId

项目或模块的名称

在groupId下必须唯一

应该使用小写字母和连字符

version

项目版本号

遵循语义化版本规范

SNAPSHOT表示开发版本

packaging

jar：Java应用程序

war：Web应用程序

pom：父项目或聚合项目

ear：企业应用程序

5.3 依赖管理

基本依赖声明

java 复制代码 
<dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>5.3.20</version>
        <scope>compile</scope>
    </dependency>
</dependencies>

依赖排除

java 复制代码 
<dependency>
    <groupId>com.example</groupId>
    <artifactId>problematic-lib</artifactId>
    <version>1.0.0</version>
    <exclusions>
        <exclusion>
            <groupId>old.lib</groupId>
            <artifactId>old-artifact</artifactId>
        </exclusion>
    </exclusions>
</dependency>

可选依赖

java 复制代码 
<dependency>
    <groupId>com.example</groupId>
    <artifactId>optional-lib</artifactId>
    <version>1.0.0</version>
    <optional>true</optional>
</dependency>

5.4 属性定义

java 复制代码 
<properties>
    <!-- 版本属性 -->
    <spring.version>5.3.20</spring.version>
    <junit.version>5.9.0</junit.version>

    <!-- 编译属性 -->
    <maven.compiler.source>11</maven.compiler.source>
    <maven.compiler.target>11</maven.compiler.target>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

    <!-- 自定义属性 -->
    <main.class>com.example.Main</main.class>
</properties>

5.5 构建配置

java 复制代码 
<build>
    <finalName>${project.artifactId}-${project.version}</finalName>

    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <filtering>true</filtering>
        </resource>
    </resources>

    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.10.1</version>
            <configuration>
                <source>11</source>
                <target>11</target>
                <encoding>UTF-8</encoding>
            </configuration>
        </plugin>
    </plugins>
</build>

5.6 继承关系

父POM

java 复制代码 
<project>
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>parent</artifactId>
    <version>1.0.0</version>
    <packaging>pom</packaging>

    <properties>
        <spring.version>5.3.20</spring.version>
    </properties>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-core</artifactId>
                <version>${spring.version}</version>
            </dependency>
        </dependencies>
    </dependencyManagement>
</project>

子POM

java 复制代码 
<project>
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>com.example</groupId>
        <artifactId>parent</artifactId>
        <version>1.0.0</version>
    </parent>

    <artifactId>child-module</artifactId>
    <packaging>jar</packaging>
</project>

第6章：依赖管理

6.1 仓库配置

中央仓库

Maven默认使用中央仓库，无需特殊配置。

镜像仓库

java 复制代码 
<!-- settings.xml -->
<mirrors>
    <mirror>
        <id>aliyun</id>
        <mirrorOf>*</mirrorOf>
        <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
    <mirror>
        <id>huawei</id>
        <mirrorOf>*</mirrorOf>
        <url>https://repo.huaweicloud.com/repository/maven/</url>
    </mirror>
</mirrors>

私有仓库

java 复制代码 
<repositories>
    <repository>
        <id>company-repo</id>
        <url>https://repo.company.com/maven2</url>
        <releases>
            <enabled>true</enabled>
        </releases>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
</repositories>

6.2 依赖范围详解

compile范围

java 复制代码 
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-core</artifactId>
    <version>5.3.20</version>
    <scope>compile</scope>  <!-- 默认范围 -->
</dependency>

test范围

java 复制代码 
<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter</artifactId>
    <version>5.9.0</version>
    <scope>test</scope>
</dependency>

provided范围

java 复制代码 
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>4.0.1</version>
    <scope>provided</scope>
</dependency>

runtime范围

java 复制代码 
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.30</version>
    <scope>runtime</scope>
</dependency>

6.3 传递依赖

Maven自动解析传递依赖：

A依赖B，B依赖C，则A间接依赖C

使用排除不需要的传递依赖

使用标记可选依赖

排除传递依赖

java 复制代码 
<dependency>
    <groupId>com.example</groupId>
    <artifactId>some-lib</artifactId>
    <version>1.0.0</version>
    <exclusions>
        <exclusion>
            <groupId>commons-logging</groupId>
            <artifactId>commons-logging</artifactId>
        </exclusion>
    </exclusions>
</dependency>

6.4 依赖冲突解决

最近优先原则

Maven使用"最近定义优先"原则解决依赖冲突。

版本管理

java 复制代码 
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
            <version>5.3.20</version>
        </dependency>
    </dependencies>
</dependencyManagement>

强制指定版本

java 复制代码 
<dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>5.3.20</version>
    </dependency>
</dependencies>

6.5 本地依赖

java 复制代码 
<dependency>
    <groupId>com.example</groupId>
    <artifactId>local-lib</artifactId>
    <version>1.0.0</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/lib/local-lib.jar</systemPath>
</dependency>

第7章：插件系统

7.1 插件基础

Maven插件分为两类：

Build plugins：参与构建过程

Reporting plugins：生成报告

插件声明

java 复制代码 
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.10.1</version>
            <configuration>
                <source>11</source>
                <target>11</target>
            </configuration>
        </plugin>
    </plugins>
</build>

7.2 常用构建插件

maven-compiler-plugin

java 复制代码 
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.10.1</version>
    <configuration>
        <source>11</source>
        <target>11</target>
        <encoding>UTF-8</encoding>
    </configuration>
</plugin>

maven-surefire-plugin

java 复制代码 
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.0.0-M9</version>
    <configuration>
        <includes>
            <include>**/*Test.java</include>
        </includes>
    </configuration>
</plugin>

maven-failsafe-plugin

java 复制代码 
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-failsafe-plugin</artifactId>
    <version>3.0.0-M9</version>
    <configuration>
        <includes>
            <include>**/*IT.java</include>
        </includes>
    </configuration>
</plugin>

maven-jar-plugin

java 复制代码 
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-jar-plugin</artifactId>
    <version>3.2.2</version>
    <configuration>
        <archive>
            <manifest>
                <mainClass>com.example.Main</mainClass>
            </manifest>
        </archive>
    </configuration>
</plugin>

7.3 报告插件

maven-site-plugin

java 复制代码 
<reporting>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-site-plugin</artifactId>
            <version>3.12.1</version>
        </plugin>
    </plugins>
</reporting>

maven-project-info-reports-plugin

java 复制代码 
<reporting>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-project-info-reports-plugin</artifactId>
            <version>3.4.1</version>
        </plugin>
    </plugins>
</reporting>

7.4 插件管理

插件版本管理

java 复制代码 
<build>
    <pluginManagement>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.10.1</version>
                <configuration>
                    <source>11</source>
                    <target>11</target>
                </configuration>
            </plugin>
        </plugins>
    </pluginManagement>
</build>

7.5 自定义插件

创建自定义Maven插件需要：

创建Maven项目

继承org.apache.maven.plugin.AbstractMojo

实现execute()方法

配置插件描述符

java 复制代码 
@Mojo(name = "hello")
public class HelloMojo extends AbstractMojo {
    @Parameter(property = "hello.message", defaultValue = "Hello World")
    private String message;

    public void execute() throws MojoExecutionException {
        getLog().info(message);
    }
}

第8章：构建生命周期

8.1 生命周期阶段
Clean生命周期

mvn pre-clean # 预清理

mvn clean # 清理

mvn post-clean # 后清理

Default生命周期

mvn validate # 验证项目结构

mvn compile # 编译主代码

mvn test # 运行测试

mvn package # 打包

mvn verify # 验证包

mvn install # 安装到本地仓库

mvn deploy # 部署到远程仓库

Site生命周期

mvn pre-site # 预站点

mvn site # 生成站点

mvn post-site # 后站点

mvn site-deploy # 部署站点

8.2 插件绑定

Maven插件默认绑定到特定的生命周期阶段：

自定义插件绑定

java 复制代码 
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-antrun-plugin</artifactId>
    <version>3.1.0</version>
    <executions>
        <execution>
            <id>custom-task</id>
            <phase>compile</phase>
            <goals>
                <goal>run</goal>
            </goals>
            <configuration>
                <target>
                    <echo message="Custom task executed"/>
                </target>
            </configuration>
        </execution>
    </executions>
</plugin>

8.3 构建Profile

Profile基础

java 复制代码 
<profiles>
    <profile>
        <id>development</id>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
        <properties>
            <db.url>jdbc:h2:mem:test</db.url>
        </properties>
    </profile>
    <profile>
        <id>production</id>
        <properties>
            <db.url>jdbc:mysql://prod-db:3306/app</db.url>
        </properties>
    </profile>
</profiles>

Profile激活

java 复制代码 
# 激活指定profile
mvn clean install -P production

# 激活多个profile
mvn clean install -P development,test

# 根据属性激活
mvn clean install -Ddb.type=mysql

8.4 自定义生命周期

通过插件可以定义自定义的构建阶段和目标。

第9章：多模块项目

9.1 聚合项目结构

java 复制代码 
parent/
├── pom.xml
├── module1/
│   └── pom.xml
├── module2/
│   └── pom.xml
└── module3/
    └── pom.xml

9.2 父POM配置

java 复制代码 
<project>
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>parent</artifactId>
    <version>1.0.0</version>
    <packaging>pom</packaging>

    <modules>
        <module>module1</module>
        <module>module2</module>
        <module>module3</module>
    </modules>

    <properties>
        <spring.version>5.3.20</spring.version>
        <junit.version>5.9.0</junit.version>
    </properties>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-core</artifactId>
                <version>${spring.version}</version>
            </dependency>
            <dependency>
                <groupId>org.junit.jupiter</groupId>
                <artifactId>junit-jupiter</artifactId>
                <version>${junit.version}</version>
                <scope>test</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <build>
        <pluginManagement>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <version>3.10.1</version>
                    <configuration>
                        <source>11</source>
                        <target>11</target>
                    </configuration>
                </plugin>
            </plugins>
        </pluginManagement>
    </build>
</project>

9.3 子模块配置

java 复制代码 
<project>
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>com.example</groupId>
        <artifactId>parent</artifactId>
        <version>1.0.0</version>
    </parent>

    <artifactId>module1</artifactId>
    <packaging>jar</packaging>

    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
        </dependency>
        <dependency>
            <groupId>com.example</groupId>
            <artifactId>module2</artifactId>
            <version>1.0.0</version>
        </dependency>
    </dependencies>
</project>

9.4 模块间依赖

java 复制代码 
<!-- module1依赖module2 -->
<dependency>
    <groupId>com.example</groupId>
    <artifactId>module2</artifactId>
    <version>${project.version}</version>
</dependency>

<!-- 使用${project.version}引用父项目的版本 -->

9.5 构建多模块项目

java 复制代码 
# 构建所有模块
mvn clean install

# 构建特定模块
mvn clean install -pl module1

# 构建模块及其依赖
mvn clean install -pl module1 -am

# 跳过测试构建
mvn clean install -DskipTests

# 并行构建
mvn clean install -T 4

第10章：测试与发布

10.1 测试配置

JUnit 5配置

java 复制代码 
<properties>
    <junit.version>5.9.0</junit.version>
    <maven.surefire.version>3.0.0-M9</maven.surefire.version>
</properties>

<dependencies>
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter</artifactId>
        <version>${junit.version}</version>
        <scope>test</scope>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>${maven.surefire.version}</version>
            <configuration>
                <includes>
                    <include>**/*Test.java</include>
                    <include>**/*Tests.java</include>
                </includes>
            </configuration>
        </plugin>
    </plugins>
</build>

TestNG配置

java 复制代码 
<dependencies>
    <dependency>
        <groupId>org.testng</groupId>
        <artifactId>testng</artifactId>
        <version>7.6.1</version>
        <scope>test</scope>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.0.0-M9</version>
            <configuration>
                <suiteXmlFiles>
                    <suiteXmlFile>testng.xml</suiteXmlFile>
                </suiteXmlFiles>
            </configuration>
        </plugin>
    </plugins>
</build>

10.2 代码覆盖率

JaCoCo配置

java 复制代码 
<properties>
    <jacoco.version>0.8.8</jacoco.version>
</properties>

<build>
    <plugins>
        <plugin>
            <groupId>org.jacoco</groupId>
            <artifactId>jacoco-maven-plugin</artifactId>
            <version>${jacoco.version}</version>
            <executions>
                <execution>
                    <goals>
                        <goal>prepare-agent</goal>
                    </goals>
                </execution>
                <execution>
                    <id>report</id>
                    <phase>test</phase>
                    <goals>
                        <goal>report</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

10.3 发布配置

distributionManagement

java 复制代码 
<distributionManagement>
    <repository>
        <id>releases</id>
        <url>https://repo.example.com/repository/maven-releases/</url>
    </repository>
    <snapshotRepository>
        <id>snapshots</id>
        <url>https://repo.example.com/repository/maven-snapshots/</url>
    </snapshotRepository>
</distributionManagement>

发布插件

java 复制代码 
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-deploy-plugin</artifactId>
            <version>3.0.0</version>
        </plugin>
    </plugins>
</build>

10.4 GPG签名

java 复制代码 
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-gpg-plugin</artifactId>
            <version>3.0.1</version>
            <executions>
                <execution>
                    <id>sign-artifacts</id>
                    <phase>verify</phase>
                    <goals>
                        <goal>sign</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

10.5 发布执行

java 复制代码 
# 发布到本地仓库
mvn clean install

# 发布到远程仓库
mvn clean deploy

# 发布站点
mvn site-deploy

# 跳过测试发布
mvn clean deploy -DskipTests

10.6 CI/CD集成

GitHub Actions示例

java 复制代码 
name: Build and Deploy
on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Set up JDK 11
        uses: actions/setup-java@v3
        with:
          java-version: '11'
          distribution: 'temurin'
          cache: maven
      - name: Build with Maven
        run: mvn clean install
      - name: Deploy
        if: github.ref == 'refs/heads/main'
        run: mvn clean deploy
        env:
          MAVEN_USERNAME: ${{ secrets.MAVEN_USERNAME }}
          MAVEN_PASSWORD: ${{ secrets.MAVEN_PASSWORD }}

第11章：性能优化

11.1 并行构建

java 复制代码 
# 并行构建
mvn clean install -T 4

# 基于CPU核心数的并行构建
mvn clean install -T 1C

11.2 增量构建

java 复制代码 
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.10.1</version>
    <configuration>
        <useIncrementalCompilation>true</useIncrementalCompilation>
    </configuration>
</plugin>

11.3 离线模式

java 复制代码 
# 下载所有依赖
mvn dependency:go-offline

# 离线构建
mvn clean install -o

11.4 跳过测试

java 复制代码 
# 跳过测试执行
mvn clean install -DskipTests

# 跳过测试编译
mvn clean install -Dmaven.test.skip=true

11.5 调试构建

java 复制代码 
# 启用调试信息
mvn clean install -X

# 调试特定插件
mvn clean install -Dmaven.plugin.debug=true

第12章：故障排除

12.1 常见问题

依赖下载失败

java 复制代码 
# 清理本地仓库
rm -rf ~/.m2/repository

# 强制重新下载
mvn clean install -U

内存不足

java 复制代码 
# 增加JVM内存
export MAVEN_OPTS="-Xmx1024m -XX:MaxPermSize=256m"
mvn clean install

插件版本冲突

java 复制代码 
<pluginManagement>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.10.1</version>
        </plugin>
    </plugins>
</pluginManagement>

12.2 调试技巧

java 复制代码 
查看依赖树
mvn dependency:tree
查看插件信息
mvn help:describe -Dplugin=org.apache.maven.plugins:maven-compiler-plugin
查看系统属性
mvn help:system
查看有效POM
mvn help:effective-pom

12.3 最佳实践

使用Maven Wrapper：确保团队使用一致的Maven版本

遵循标准目录结构：使用Maven约定

合理组织依赖：避免不必要的传递依赖

使用依赖管理：统一管理版本号

编写可维护的POM：清晰的配置和注释

定期更新依赖：保持依赖版本最新

使用CI/CD：自动化构建和测试流程

配置镜像仓库：提高下载速度

相关推荐
多多*14 小时前
maven常用的命令
java·log4j·maven
水月wwww21 小时前
Maven项目及Tomcat配置（IDEA）
tomcat·maven·intellij-idea·javaweb
高斯林.神犇1 天前
maven专题
maven
.格子衫.1 天前
Maven的下载与安装
java·maven
Override笑看人生1 天前
gitlab中maven私有库使用备忘
java·gitlab·maven
原来是小珠呀1 天前
Maven介绍安装与IDEA使用（JavaWeb）
pycharm·maven·intellij-idea
不知几秋1 天前
配置JDK和MAVEN
java·开发语言·maven
多多*2 天前
分布式系统中的CAP理论和BASE理论
java·数据结构·算法·log4j·maven
多多*2 天前
牛客周赛 Round 117 ABCDE 题解
java·开发语言·数据结构·算法·log4j·maven
热门推荐
01GitHub 镜像站点02UV安装并设置国内源03Linux下V2Ray安装配置指南04安娜的档案(Anna’s Archive) 镜像网站/国内最新可访问入口（持续更新）05综合整理：pdf预览显示：你尝试预览的文件可能对你的计算机有害。如果你信任此文件以及其来源，请打开此文件以看其内容，如何解决以正常预览文件06Labelme从安装到标注：零基础完整指南07BongoCat - 跨平台键盘猫动画工具08智能库存管理的需求预测模型：从业务痛点到落地代码的完整实践09《大数据技术原理与应用》实验报告三 熟悉HBase常用操作10全面评测 | Photoshop 2026 新特性深度解析与实测体验