构建与依赖 / 系统课时

三套内置生命周期

三套内置生命周期

Maven 的 clean、default、site 不是一条长流水线的三个阶段,而是三套彼此独立的生命周期。掌握它们后,你能根据结果选择正确命令,并理解为什么 mvn clean package 会先清理旧产物,再从默认生命周期一路执行到 package。

学习目标

  • 说清 clean、default、site 各自解决的问题。
  • 判断一个命令会进入哪套生命周期,以及会执行到哪个阶段。
  • 用一个最小 JAR 工程验证三套生命周期产生的不同结果。

用产物区分三套生命周期

本文命令语义适用于 Maven 3.9/3.10;Maven 4.0.0-rc-7 仍提供这三套内置生命周期。最实用的判断方式不是背定义,而是看命令改变了什么:clean 删除旧构建输出,default 负责编译、测试、打包到部署,site 负责生成和发布项目站点。

生命周期 常用阶段 直接结果 典型使用时机
clean pre-clean、clean、post-clean 删除前一次构建生成的文件,通常是 target/ 怀疑旧产物污染构建,或准备做一次干净构建
default validate 到 deploy 产生编译结果、测试结果、JAR/WAR、本地或远程仓库产物 日常开发、CI 构建、发布制品
site pre-site、site、post-site、site-deploy 生成项目站点,通常位于 target/site/ 生成 Maven Site 文档或发布站点

Maven 三套内置生命周期及其独立执行关系

在同一工程分别执行三套生命周期

下面示例以 Bash、JDK 17、Maven 3.9+ 为环境,脚本会创建一个最小 JAR 工程,并分别验证 clean、package、site。首次运行会下载插件和依赖,因此耗时会比后续执行更长。

bash
rm -rf lifecycle-demo
mkdir -p lifecycle-demo/src/main/java/demo
cd lifecycle-demo

# 创建最小 POM,并固定编译器与 Site 插件版本。
cat > pom.xml <<'EOF'
<project xmlns="http://maven.apache.org/POM/4.0.0">
  <modelVersion>4.0.0</modelVersion>
  <groupId>demo</groupId>
  <artifactId>lifecycle-demo</artifactId>
  <version>1.0.0</version>
  <properties>
    <maven.compiler.release>17</maven.compiler.release>
  </properties>
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.16.0</version>
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-site-plugin</artifactId>
        <version>3.22.0</version>
      </plugin>
    </plugins>
  </build>
</project>
EOF

# 添加一个可编译的主类,避免 compile 变成空操作。
cat > src/main/java/demo/App.java <<'EOF'
package demo;
public class App {
    public static void main(String[] args) {
        System.out.println("lifecycle-demo");
    }
}
EOF

# 用文件是否存在来验证每套生命周期的效果。
mkdir -p target && touch target/stale.txt
mvn -q clean >/dev/null && test ! -e target/stale.txt && echo "clean: target removed"
mvn -q package >/dev/null && test -f target/lifecycle-demo-1.0.0.jar && echo "default: jar created"
mvn -q site >/dev/null && test -f target/site/index.html && echo "site: index generated"
mvn -q clean package >/dev/null && test -f target/lifecycle-demo-1.0.0.jar && echo "clean + package: jar recreated"

预期输出如下;不同 Maven/JDK 环境可能额外输出警告,但四个检查结果应一致。

text
clean: target removed
default: jar created
site: index generated
clean + package: jar recreated

跨生命周期组合时按命令顺序执行

mvn clean package 不是“进入 default 后自动顺便 clean”,而是 Maven 按命令行从左到右处理两个阶段:先执行 clean 生命周期直到 clean,再执行 default 生命周期直到 package。因此它能确保旧的 target/ 被删除后再重新编译和打包。

同理,mvn clean deploy site-deploy 会依次完成清理、默认生命周期直到 deploy,再执行站点生命周期直到 site-deploy。这类组合适合 CI;本地开发通常只执行达到当前目标所需的最远阶段,避免无意义地部署制品或站点。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

三套内置生命周期

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通