Maven 生命周期与插件绑定

一、核心概念

Maven 有三个核心概念，很多人容易混淆：

总结：生命周期定义"什么时候做"，插件定义"做什么"，绑定决定"做哪个"。

二、三大生命周期（Lifecycle）

Maven 内置了 3 个独立的生命周期：

关键理解

• 三大生命周期相互独立，执行 mvn clean install 是先跑 clean 生命周期，再跑 default 生命周期。
• 但 default 内部的 phase 是顺序执行的：执行 mvn package 会自动先执行 validate、compile、test，最后才执行 package。

三、default 生命周期完整阶段（22 个）

四、插件默认绑定关系

以下插件有默认绑定，无需在 POM 中显式配置即可工作：

五、自定义插件绑定（<executions>）

如果想在某个阶段执行自定义插件，使用 <executions> 配置：

示例 1：在 compile 阶段自动生成代码

<build>
    <plugins>
        <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>jaxb2-maven-plugin</artifactId>
            <version>2.5.0</version>
            <executions>
                <execution>
                    <id>generate-sources</id>
                    <!-- 自定义绑定到 generate-sources 阶段 -->
                    <phase>generate-sources</phase>
                    <goals>
                        <goal>xjc</goal>
                    </goals>
                </execution>
            </executions>
            <configuration>
                <sources>src/main/xsd</sources>
            </configuration>
        </plugin>
    </plugins>
</build>

示例 2：package 阶段复制依赖到 lib 目录

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-dependency-plugin</artifactId>
            <version>3.6.0</version>
            <executions>
                <execution>
                    <id>copy-dependencies</id>
                    <phase>package</phase>
                    <goals>
                        <goal>copy-dependencies</goal>
                    </goals>
                    <configuration>
                        <outputDirectory>${project.build.directory}/lib</outputDirectory>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

示例 3：绑定多个 goal 到不同阶段

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-antrun-plugin</artifactId>
            <version>3.1.0</version>
            <executions>
                <!-- 绑定到 clean 阶段 -->
                <execution>
                    <id>clean-something</id>
                    <phase>clean</phase>
                    <goals><goal>run</goal></goals>
                    <configuration>
                        <target>
                            <echo>Cleaning custom dir...</echo>
                            <delete dir="target/custom" />
                        </target>
                    </configuration>
                </execution>
                <!-- 绑定到 package 阶段 -->
                <execution>
                    <id>package-something</id>
                    <phase>package</phase>
                    <goals><goal>run</goal></goals>
                    <configuration>
                        <target>
                            <echo>Packaging custom files...</echo>
                            <copy todir="target/custom">
                                <fileset dir="src/main/custom" />
                            </copy>
                        </target>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

六、常用命令与阶段对应关系

七、跳过特定阶段的配置

八、自定义生命周期阶段

极少使用，但可以通过 maven-plugin-plugin 自定义新的阶段：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-plugin-plugin</artifactId>
    <version>3.9.0</version>
    <configuration>
        <mojoDependencies>
            <dependency>com.mycompany:my-custom-plugin</dependency>
        </mojoDependencies>
    </configuration>
</plugin>

实际开发中几乎不需要自定义生命周期。

九、调试技巧：查看插件绑定关系

1. 查看当前项目的所有阶段绑定

mvn help:describe -Dcmd=compile

2. 查看特定插件的所有 goal

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

3. 查看 effective POM 中的插件配置

mvn help:effective-pom | grep -A 20 "plugins"

4. 查看执行时的详细绑定日志

mvn compile -X | grep "binding"

十、核心要点

十一、图解执行流程

mvn clean install 的执行过程：

┌─────────────────────────────────────────────────────────────┐
│  clean 生命周期（独立）                                     │
│  pre-clean → clean（删除 target/）→ post-clean             │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│  default 生命周期（顺序执行）                               │
│  validate                                                   │
│    ↓                                                        │
│  compile  ←─── maven-compiler-plugin:compile               │
│    ↓                                                        │
│  test  ←───── maven-surefire-plugin:test                   │
│    ↓                                                        │
│  package ←─── maven-jar-plugin:jar                         │
│    ↓                                                        │
│  install ←─── maven-install-plugin:install                 │
└─────────────────────────────────────────────────────────────┘

总结：生命周期定义顺序（什么时候做），插件目标执行动作（做什么），绑定把二者连起来。理解这层关系，就能灵活控制 Maven 构建的每个环节。