生命周期

摘要：本文了解了Maven三大独立生命周期的阶段组成与核心作用，学习了如何对生命周期进行定制。

1 定义

Maven生命周期是一套标准化的项目构建流程约定，它定义了项目发版的全流程步骤，并规定了这些步骤的执行顺序。其核心价值在于：

• 自动化：按约定顺序自动执行构建步骤，无需手动分步操作。
• 标准化：所有Maven项目遵循同一套目录结构和构建流程。
• 基石：Maven的插件需绑定到生命周期的特定阶段才能生效，生命周期是插件运行的基石。

2 生命周期

Maven将构建流程拆分为三个完全独立的生命周期：Clean（清理）、Default（核心构建）、Site（文档生成）。三者互不干扰，可单独执行（如仅清理不构建，或仅生成文档不清理），也可组合执行（如先清理再构建）。

2.1 Clean

2.1.1 说明

Clean生命周期的核心作用是删除上一次构建生成的临时文件（如target目录），为新构建提供干净环境，避免旧文件残留导致构建异常。

2.1.2 组成

阶段组成：

2.1.3 注意

执行mvn clean命令仅触发pre-clean阶段和clean阶段，不会触发post-clean阶段，需显式配置插件才会执行。

触发clean阶段仅删除默认target目录，若有自定义输出目录，需通过maven-clean-plugin配置额外清理路径。

Clean生命周期与其他生命周期完全独立，需显式执行mvn clean命令才会触发Clean生命周期。

2.2 Default

2.2.1 说明

Default生命周期是Maven最核心的生命周期，覆盖全流程，几乎所有日常构建操作都基于此生命周期。

核心特性：

• 阶段顺序固定：所有阶段按前置依赖顺序执行，执行某个阶段时，会自动触发其所有前置阶段。
• 阶段数量多：包含23个阶段，日常开发仅关注核心阶段。
• 插件绑定：每个阶段的功能由对应的Maven插件实现。

2.2.2 组成

阶段组成：

2.2.3 注意

命令与阶段对应关系：

2.3 Site

2.3.1 说明

Site生命周期的核心作用是自动生成项目的标准化文档站点，包含项目说明、依赖报告、测试报告、团队信息等，方便团队协作与项目维护。

2.3.2 组成

阶段组成：

2.3.3 注意

命令与阶段对应关系：

执行mvn site-deploy命令需先在pom.xml文件中配置远程站点仓库：

1
2
3
4
5
6

<distributionManagement>
  <site>
    <id>github-pages</id>
    <url>scm:git:https://github.com/your-name/your-repo.git</url>
  </site>
</distributionManagement>

3 行为定制

3.1 跳过测试

如果需要临时跳过测试环节，有两种方式配置：

• 执行mvn test -DskipTests命令会跳过测试执行，但不会跳过测试编译，仍会编译测试源码。适用于快速打包的场景。
• 执行mvn test -Dmaven.test.skip=true命令会跳过测试编译和测试执行。适用于测试代码尚未开发完成的场景。

如果需要永久跳过测试环节，需要修改pom.xml文件：

1
2
3
4
5
6
7
8
9
10
11
12

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-surefire-plugin</artifactId>
      <version>3.2.2</version>
      <configuration>
        <skip>true</skip>
      </configuration>
    </plugin>
  </plugins>
</build>

3.2 指定阶段

若仅需执行某个阶段，直接调用该阶段的命令即可。

示例：

• 执行mvn process-resources命令仅处理主程序资源文件，不编译文件。
• 执行mvn test-compile命令仅编译测试代码，不执行测试。

3.3 绑定插件

Maven生命周期的阶段本身不实现具体功能，而是绑定到对应的插件目标来完成工作。

绑定方式：

• 默认绑定：Maven为核心阶段预设了插件。
• 自定义绑定：可以为某个阶段绑定指定插件。

示例：为package阶段绑定Javadoc插件：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-javadoc-plugin</artifactId>
      <version>3.5.0</version>
      <executions>
        <!-- 绑定到package阶段，执行package时自动生成Javadoc -->
        <execution>
          <phase>package</phase>
          <goals>
            <goal>javadoc</goal>
          </goals>
          <configuration>
            <encoding>UTF-8</encoding> <!-- 解决中文注释乱码 -->
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>