Maven 构建工具：生命周期、依赖与插件

FreeGuideOnline 最新 2026-06-17

Maven 构建工具完全指南：生命周期、依赖与插件

为什么选择 Maven

在 Java 生态中，项目构建是开发流程的关键环节。早期的项目构建依赖手动管理 Jar 包、编写复杂的 Ant 脚本，效率低下且容易出错。Maven 的出现彻底改变了这一局面——它提供了一整套标准化的项目对象模型（POM）、依赖管理系统、插件化构建生命周期，让开发者能够专注于业务逻辑，而不是配置细节。

本教程将从零开始，带你深入理解 Maven 的核心概念：生命周期、依赖管理与插件机制。无论你是刚接触 Java 构建的新手，还是希望梳理 Maven 底层原理的开发者，这篇文章都将帮助你建立系统化的知识体系。

Maven 基础概念

约定优于配置

Maven 的核心哲学是“约定优于配置”（Convention over Configuration）。它预定义了项目目录结构、编译输出路径、测试资源位置等，你只需遵循这些约定，即可大幅减少配置文件。例如：

src/main/java —— 主代码源文件
src/main/resources —— 主资源文件
src/test/java —— 测试代码
src/test/resources —— 测试资源
target/ —— 构建输出目录

POM 文件与坐标系统

每个 Maven 项目根目录下都有一个 pom.xml，它是项目的核心描述文件。Maven 通过“坐标”唯一定位一个构件（artifact），坐标由以下元素组成：

groupId：组织或公司域名反写（如 com.example）
artifactId：项目或模块名（如 my-app）
version：版本号（如 1.0.0）

一个典型的最小 POM 如下：

<project>
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.example</groupId>
  <artifactId>my-app</artifactId>
  <version>1.0-SNAPSHOT</version>
</project>

Maven 生命周期详解

Maven 构建过程围绕“生命周期”展开。生命周期是一组有序的阶段（phase），执行某个阶段时，其之前的所有阶段都会按顺序执行。Maven 提供了三套独立的生命周期：clean、default、site。我们最常用的是 default 生命周期。

Clean 生命周期

用于清理项目，包含三个阶段：

pre-clean：清理前需要完成的工作
clean：删除上一次构建生成的所有文件（默认是 target 目录）
post-clean：清理后需要完成的工作

执行命令 mvn clean 会触发 clean 阶段，并自动先运行 pre-clean。

Default 生命周期（核心）

Default 生命周期是整个构建流程的核心，涵盖从验证到部署的完整过程。以下是其关键阶段（按执行顺序排列）：

阶段一览

阶段	说明
validate	验证项目结构完整性，检查 POM 配置是否正确
compile	编译 `src/main/java` 下的源代码，输出到 `target/classes`
test	运行 `src/test/java` 下的单元测试，使用合适的测试框架
package	将编译后的代码打包成可分发的格式，如 JAR、WAR
verify	运行集成测试，检查包的有效性、质量
install	将打包的构件安装到本地仓库，供其他本地项目依赖
deploy	将最终构件部署到远程仓库，供其他开发者和项目共享

执行示例

mvn compile：执行从 validate 到 compile 的所有前置阶段
mvn test：执行 validate、compile、test
mvn package：执行 validate → compile → test → package

若只想执行到某个阶段而不触发前置阶段，可以使用参数跳过，但这通常不推荐，因为阶段之间的产出物是依赖的。

Site 生命周期

用于生成项目站点文档，包含：

pre-site：生成站点前的准备
site：生成项目站点文档（HTML 等各种报告）
post-site：完成站点生成后的工作
site-deploy：将生成的站点部署到 Web 服务器

一般通过 mvn site 命令触发。

生命周期与插件的关系

生命周期本身只定义了阶段顺序，实际工作由**插件目标（goal）**完成。每个阶段都可以绑定一个或多个插件目标。例如：

compile 阶段默认绑定 maven-compiler-plugin 的 compile 目标
test 阶段绑定 maven-surefire-plugin 的 test 目标

你可以在 POM 中修改或增加绑定，从而实现自定义构建行为。

Maven 依赖管理精讲

依赖管理是 Maven 最强大的特性之一。它能自动下载项目所需的外部类库，并递归解析传递性依赖，解决了令人头疼的“Jar 包地狱”。

依赖声明基础

在 pom.xml 中使用 <dependencies> 元素声明依赖：

<dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>5.3.23</version>
    </dependency>
</dependencies>

依赖范围（scope）

合理使用依赖范围可以控制依赖在编译、测试、运行时的可见性，避免类冲突并减小包体积。常用范围如下：

compile（默认）：编译、测试、运行都可用，会传递给下游项目
provided：编译和测试时需要，但运行时由 JDK 或容器提供（如 Servlet API）。不会传递
runtime：测试和运行时需要，编译时不需要（如 JDBC 驱动实现）
test：仅测试编译和测试运行可用（如 JUnit），不会传递
system：与 provided 类似，但必须显式提供 jar 路径。已废弃，不推荐
import：仅在 <dependencyManagement> 中用于导入其他 POM 的依赖管理配置

明确设置 scope 能避免部署运行时出现类缺失或冲突。例如：

<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>4.0.1</version>
    <scope>provided</scope>
</dependency>

传递性依赖与冲突调解

Maven 自动解析依赖的依赖（传递性依赖）。当多个依赖引入了同一个构件但版本不同时，会产生冲突。Maven 的调解原则：

最短路径优先：依赖树中路径更短的版本胜出
先声明优先：当路径长度相同时，在 POM 中先声明的依赖版本胜出

为了明确控制版本，你可以：

在 <dependencyManagement> 中统一指定版本号，子模块声明依赖时可省略 <version>
使用 <exclusions> 主动排除某个传递性依赖

依赖管理元素 `<dependencyManagement>`

通常在父 POM 中使用，用于集中管理版本号，但并不直接引入依赖。子 POM 只需声明 groupId 和 artifactId 即可继承版本号，实现全局版本控制。

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.google.guava</groupId>
            <artifactId>guava</artifactId>
            <version>31.1-jre</version>
        </dependency>
    </dependencies>
</dependencyManagement>

子模块使用时：

<dependencies>
    <dependency>
        <groupId>com.google.guava</groupId>
        <artifactId>guava</artifactId>
        <!-- 无需指定版本 -->
    </dependency>
</dependencies>

可选依赖与排除

可选依赖：设置 <optional>true</optional>，意味着该依赖不会传递给下游项目
排除依赖：使用 <exclusions> 排除不希望引入的传递性依赖，常用于解决版本冲突或减少无用 jar

<dependency>
    <groupId>org.example</groupId>
    <artifactId>some-lib</artifactId>
    <version>1.0</version>
    <exclusions>
        <exclusion>
            <groupId>commons-logging</groupId>
            <artifactId>commons-logging</artifactId>
        </exclusion>
    </exclusions>
</dependency>

Maven 插件体系

Maven 的本质是一个插件执行框架，所有具体任务都由插件完成。插件由多个“目标”（Goal）组成，一个目标代表一个具体任务。

插件配置方式

插件可以在 POM 的 <build> 或 <reporting> 下配置。常见配置位置：

<build><plugins>：全局构建插件
<build><pluginManagement><plugins>：统一管理插件版本和配置，子模块继承使用
<profiles>：按环境激活不同插件配置

一个典型插件配置示例（编译插件指定 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>

核心插件介绍

Maven 通过插件完成编译、测试、打包等工作，理解核心插件的用途会让你从容应对各种构建需求。

maven-compiler-plugin

控制源代码编译。常用配置指定 JDK 版本、编译参数等。

maven-surefire-plugin

负责运行单元测试。它可以指定测试包含/排除模式、测试报告生成等。

maven-jar-plugin / maven-war-plugin

负责打包成 JAR 或 WAR 文件。可以配置主类、清单条目等。

maven-install-plugin / maven-deploy-plugin

install 将构件安装到本地仓库，deploy 部署到远程仓库。这两个插件通常随生命周期自动绑定，无需显式配置。

maven-clean-plugin

默认绑定到 clean 阶段，负责删除 target 目录。

maven-resources-plugin

负责复制资源文件（如配置文件）到输出目录，支持资源过滤（替换占位符）。

exec-maven-plugin 等第三方插件

Maven 强大的插件生态允许你运行 Java 程序、生成代码、启动应用服务器等。例如 exec-maven-plugin 可以在构建中执行外部命令或 Java 类。

插件与生命周期绑定

插件目标默认可以绑定到某个生命周期阶段。你可以在 <executions> 中自定义绑定：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-antrun-plugin</artifactId>
    <version>3.1.0</version>
    <executions>
        <execution>
            <id>echo</id>
            <phase>compile</phase>
            <goals>
                <goal>run</goal>
            </goals>
            <configuration>
                <target>
                    <echo>Compilation done!</echo>
                </target>
            </configuration>
        </execution>
    </executions>
</plugin>

这段配置让 Ant run 目标在 compile 阶段额外执行。

实战：构建一个典型的 Java 项目

假设我们要构建一个简单的 Spring Boot 应用，下面展示 pom.xml 的关键结构，串联生命周期、依赖与插件。

<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>demo-app</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.5</version>
    </parent>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

执行流程解析：

mvn clean 清除上次构建（clean 生命周期）
mvn package 将经历 default 生命周期的 validate → compile → test → package
- compile 阶段：maven-compiler-plugin 编译源代码
- test 阶段：maven-surefire-plugin 运行测试
- package 阶段：spring-boot-maven-plugin 生成可执行 JAR
如果需要将最终 jar 安装到本地仓库，执行 mvn install；部署到远程仓库用 mvn deploy

Maven 的最佳实践与常见问题

版本规范建议

线上发布版使用固定版本号，如 1.0.0
开发中的版本使用 SNAPSHOT，如 1.0.0-SNAPSHOT，方便持续集成
使用属性统一管理版本号：<properties><java.version>11</java.version></properties>

多模块项目构建

通过 <modules> 元素管理父子模块：

<modules>
    <module>core</module>
    <module>web</module>
</modules>

父 POM 使用 <dependencyManagement> 和 <pluginManagement> 统一版本，子模块聚焦自身依赖。

依赖冲突快速排查

使用命令 mvn dependency:tree 查看完整的依赖树，快速定位冲突来源。

配置文件资源过滤

启用资源过滤可以在构建时将 Maven 属性注入到配置文件：

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

在 .properties 文件中使用 ${project.version} 等占位符即可在构建时替换。

跳过测试

在某些快速构建场景，可以使用 -DskipTests（跳过测试执行但编译测试代码）或 -Dmaven.test.skip=true（完全跳过测试编译和执行）。

总结

Maven 的三大支柱——生命周期、依赖管理、插件机制——共同构建了一个强大而灵活的构建平台。理解它们之间的关系，会让你在解决构建问题时游刃有余：

生命周期定义了构建的阶段顺序，让构建过程清晰可控
依赖管理解决了包冲突和版本控制，是项目可复现的基石
插件则是实际工作的执行者，通过绑定和配置可以满足几乎所有定制需求

掌握这些核心知识后，你不仅能高效构建 Java 项目，还能轻松驾驭复杂的多模块、多环境工程。从今天开始，让 Maven 成为你生产力工具箱中最可靠的成员。