构建与依赖 / 系统课时
命令组合与执行顺序
命令组合与执行顺序
Maven 命令行可以一次写多个阶段或插件目标,但顺序会直接改变构建结果。最容易踩坑的是把 clean 放到错误位置,或者重复写同一生命周期中的前置阶段。掌握左到右的执行规则后,就能预测哪些测试会跑、何时产出 JAR,以及最终产物是否还存在。
学习目标
- 判断执行某个阶段时,同一生命周期中哪些前置阶段会一并执行。
- 解释
clean package、package clean等组合为什么得到不同结果。 - 为常见的测试、打包、安装和部署任务选择最短且明确的命令。
一个阶段会带上同一生命周期的前置阶段
生命周期阶段不是孤立动作。对 default 生命周期执行 mvn package 时,Maven 会从生命周期起点一直执行到 package;其中会经过 validate、process-resources、compile、test 等关键阶段,以及这些阶段绑定的插件目标。没有测试源码时,测试插件仍可能执行,但不会凭空生成测试。

对 jar 项目来说,如果只需要完成单元测试,执行到 test 即可;如果需要 JAR,则执行到 package;如果还要运行绑定在 verify 前后的质量检查或集成测试,就执行到 verify。不要为了“保险”把 test package verify 全写上,直接选择最靠后的必要阶段更清楚。
多个命令按参数顺序组成构建计划
命令行中的任务按书写顺序处理。clean 属于 clean 生命周期,package 属于 default 生命周期,因此 mvn clean package 是“先清理,再打包”;反过来的 mvn package clean 是“先打包,再清理”,最终通常连 target 目录都会被删除。
下面示例适用于 packaging 为 jar、且测试能够通过的 Maven 项目,并假设在支持 Bash、find 与 grep 的环境中执行。它连续验证两种顺序,不依赖 Maven 日志格式。
set -e
mvn -q clean package
find target -maxdepth 1 -type f -name '*.jar' -print -quit | grep -q . \
&& echo "clean-package: jar exists"
mvn -q package clean
if [ ! -d target ]; then
echo "package-clean: target removed"
fi预期输出:
clean-package: jar exists
package-clean: target removed第一行说明 clean package 最终留下了 JAR;第二行说明 package clean 虽然先完成过打包,但随后执行 clean 删除了构建目录。发布脚本里如果把 clean 放在最后,后续上传步骤就可能找不到产物。
阶段与直接目标可以混合,但位置仍然重要
Maven 允许把生命周期阶段和插件目标放在同一次调用中,例如 mvn clean dependency:tree package。它的阅读方式是:先执行 clean 生命周期到 clean,再直接运行 dependency:tree,随后执行 default 生命周期到 package。直接目标只在它出现的位置执行,不会自动变成某个阶段。
这种写法适合临时诊断,但 CI 脚本应尽量保持命令短而稳定。需要长期固定某个目标在构建中的执行时点时,应把目标通过 <execution> 绑定到明确阶段,而不是依赖所有人都记住一串特殊命令。
常用组合按最终产物选择
选择命令时先问“最终要到哪个阶段”,再决定是否需要先清理。下面这些组合覆盖大多数 Java 项目的日常场景;其中 deploy 还要求远程仓库和凭据配置正确。
| 需求 | 推荐命令 | 结果 |
|---|---|---|
| 从干净目录运行单元测试 | mvn clean test |
编译并测试,不要求生成最终 JAR |
| 从干净目录生成包 | mvn clean package |
生成 target 下的包文件 |
| 跑到验证阶段 | mvn clean verify |
包含 package,并继续执行到 verify |
| 安装到本地仓库 | mvn clean install |
在验证后把产物安装到本地仓库 |
| 发布到远程仓库 | mvn clean deploy |
在安装之后继续执行部署阶段 |
同一生命周期中通常只写最靠后的必要阶段:package 已经包含它之前的 default 生命周期阶段。不同生命周期则按命令行顺序组合,最典型就是先 clean,再执行 default 生命周期到你真正需要的终点。