构建与依赖 / 系统课时

命令组合与执行顺序

命令组合与执行顺序

Maven 命令行可以一次写多个阶段或插件目标,但顺序会直接改变构建结果。最容易踩坑的是把 clean 放到错误位置,或者重复写同一生命周期中的前置阶段。掌握左到右的执行规则后,就能预测哪些测试会跑、何时产出 JAR,以及最终产物是否还存在。

学习目标

  • 判断执行某个阶段时,同一生命周期中哪些前置阶段会一并执行。
  • 解释 clean package、package clean 等组合为什么得到不同结果。
  • 为常见的测试、打包、安装和部署任务选择最短且明确的命令。

一个阶段会带上同一生命周期的前置阶段

生命周期阶段不是孤立动作。对 default 生命周期执行 mvn package 时,Maven 会从生命周期起点一直执行到 package;其中会经过 validate、process-resources、compile、test 等关键阶段,以及这些阶段绑定的插件目标。没有测试源码时,测试插件仍可能执行,但不会凭空生成测试。

Maven 命令组合执行顺序

对 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 日志格式。

bash
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

预期输出:

text
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 生命周期到你真正需要的终点。

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

目录与阅读设置

阅读设置

17

记录一个想法

命令组合与执行顺序

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

登录哪都通