插件概述

本章是"插件"章节的总纲。理解插件在 Maven 中的核心地位，是后续学习具体插件（如 compiler、surefire、war）的前提。如果说生命周期是"剧本"，插件就是"演员"——剧本规定了场次，演员负责登台表演。

核心机制

这句话的潜台词是：Maven 本身几乎什么都不做，所有实际工作都由插件完成。Maven 引擎只负责三件事：

解析 pom.xml
计算生命周期阶段
在正确的阶段调用正确的插件

编译代码？maven-compiler-plugin 干的。运行测试？maven-surefire-plugin 干的。打包 WAR？maven-war-plugin 干的。Maven 只是那个拿着喇叭喊"各部门准备——Action！"的导演。

"Maven 本身不干活，插件干活"

这是理解 Maven 插件体系的第一性原理。让我们拆解一次 mvn compile 的真实执行过程：

步骤	Maven 引擎做什么	插件做什么
1	读取 `pom.xml`，确认当前阶段是 `compile`	—
2	查找 `compile` 阶段绑定的默认插件	`maven-compiler-plugin` 准备就绪
3	解析插件坐标，从本地/远程仓库下载插件	插件 JAR 被加载到内存
4	调用插件的 `compile` 目标（goal）	调用 JDK 的 `javac` 编译源代码
5	收集编译结果，准备进入下一阶段	生成 `.class` 文件到 `target/classes`

可以看到，Maven 引擎是"调度中心"，插件是"施工队"。没有插件，Maven 就是一个空壳。

插件坐标：GAV 的另一种形式

插件本身也是 Maven 构件，因此也有坐标。插件坐标的格式与普通依赖完全一致：

groupId:artifactId:version

例如 maven-compiler-plugin 的坐标是：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.11.0</version>
</plugin>

Maven boot-maven-plugin`）。

插件目标（Goal）

一个插件可以包含多个目标（Goal），每个目标对应一个具体任务。例如 maven-compiler-plugin 有两个核心目标：

目标	作用
`compiler:compile`	编译主源代码（`src/main/java`）
`compiler:testCompile`	编译测试代码（`src/test/java`）

生命周期阶段与插件目标的绑定是 Maven 自动运转的关键。compile 阶段默认绑定 compiler:compile，test-compile 阶段默认绑定 compiler:testCompile。

生活类比：剧组的导演与演员

想象 Maven 是一个电影剧组：

Maven 引擎 = 导演。导演不亲自化妆、不亲自打光、不亲自表演。导演的工作是：看剧本（pom.xml）、排场次（生命周期）、喊"Action"（调用插件）。
插件 = 各部门工作人员。摄影组（compiler-plugin）负责拍摄，灯光组（surefire-plugin）负责照亮测试场景，后期组（jar-plugin）负责剪辑成片。
目标（Goal） = 每个部门的具体任务。摄影组今天拍外景（compile），明天拍绿幕（testCompile）。

没有导演，剧组一盘散沙；没有演员和工作人员，导演只能对着空场地发呆。Maven 和插件的关系，就是导演与剧组的关系。

图示

上图展示了 Maven 的核心架构：引擎负责调度，插件负责执行，最终产生构建产物。开发者通过 pom.xml 声明"需要什么插件、用什么版本、配什么参数"，Maven 引擎在生命周期阶段触发插件执行。

完整示例

场景

飞翔科技的 employee-system 项目需要支持 Java 17，并且要在打包时排除某些配置文件。CTO 大翔让架构师白歌调研：这些工作到底是 Maven 做的，还是插件做的？

操作前：项目状态

当前 pom.xml 没有显式声明任何插件，完全依赖 Maven 的默认绑定：

<?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.feixiang</groupId>
    <artifactId>employee-system</artifactId>
    <version>1.0.0</version>
    <packaging>jar</packaging>

    <dependencies>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter</artifactId>
            <version>5.9.2</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
</project>

操作步骤：显式声明插件

白歌决定显式声明编译插件和打包插件，以精确控制构建行为：

<build>
    <plugins>
        <!-- 编译插件：控制 Java 版本 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.11.0</version>
            <configuration>
                <source>17</source>
                <target>17</target>
                <encoding>UTF-8</encoding>
            </configuration>
        </plugin>

        <!-- JAR 打包插件：排除配置文件 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>3.3.0</version>
            <configuration>
                <excludes>
                    <exclude>**/application-dev.yml</exclude>
                </excludes>
            </configuration>
        </plugin>
    </plugins>
</build>

操作结果及分析

执行 mvn clean compile：

$ mvn clean compile
[INFO] --- maven-clean-plugin:3.2.0:clean (default-clean) @ employee-system ---
[INFO] Deleting C:\workspace\employee-system\target
[INFO] --- maven-resources-plugin:3.3.1:resources (default-resources) @ employee-system ---
[INFO] Copying 1 resource
[INFO] --- maven-compiler-plugin:3.11.0:compile (default-compile) @ employee-system ---
[INFO] Compiling 5 source files to C:\workspace\employee-system\target\classes
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS

变化分析：

小崔注意到：即使没有在 pom.xml 里写 maven-clean-plugin 和 maven-resources-plugin，它们依然被执行了——这是 Maven 的隐式绑定
白歌确认：maven-compiler-plugin:3.11.0 被显式调用，而不是默认的 3.1.0 版本
李眉发现：最终 JAR 包里确实没有 application-dev.yml，因为 maven-jar-plugin 按配置排除了它

关键结论：所有实际工作都是插件完成的。Maven 引擎只是按生命周期顺序，依次触发 clean-plugin → resources-plugin → compiler-plugin。