构建与依赖 / 系统课时
三套内置生命周期
三套内置生命周期
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 文档或发布站点 |

在同一工程分别执行三套生命周期
下面示例以 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;本地开发通常只执行达到当前目标所需的最远阶段,避免无意义地部署制品或站点。
按自己的节奏,确认真正理解。