构建与依赖 / 系统课时

常用构建阶段

常用构建阶段

Maven 日常最常见的七个阶段是 validate、compile、test、package、verify、install 和 deploy。关键规则只有一条:调用默认生命周期中较后的阶段时,Maven 会先按顺序执行它之前的阶段,因此通常不需要把每个阶段都写在命令行里。

学习目标

  • 说清七个常用阶段各自产生什么结果。
  • 根据“只执行到最远目标阶段”的规则选择构建命令。
  • 区分 package、verify、install、deploy 的边界和副作用。

用最远阶段决定执行范围

对于默认生命周期,执行 mvn verify 时会先经过 validate、编译、测试、打包以及集成测试相关阶段,再到 verify;执行 mvn install 还会继续把制品写入本地仓库。下面这张图适合直接作为命令选择表来读。

Maven 常用构建阶段的顺序与产物

阶段 你可以直接检查的结果 适合什么时候调用
validate POM 与项目基本信息能被 Maven 正常读取 只想快速确认项目模型是否可解析
compile 主源码完成编译,JAR 项目通常出现 target/classes/ 修改生产代码后检查编译错误
test 单元测试执行完成,Surefire 报告通常在 target/surefire-reports/ 本地快速回归
package 生成 JAR/WAR 等可分发文件 需要拿到构建产物
verify 在打包后继续执行集成验证和质量检查 提交前或 CI 的常规完整验证
install 制品写入本机 ~/.m2/repository/ 另一个本地 Maven 工程要依赖当前快照或版本
deploy 制品上传到配置好的远程仓库 CI、发布流水线或共享制品仓库

跑到 verify 观察前序阶段

以 artifactId=stage-demo、version=1.0.0 的普通 JAR 工程为例,在项目根目录执行 clean verify。clean 先清理旧输出,verify 再从默认生命周期起点一路运行到验证阶段;不需要写成 validate compile test package verify。

bash
mvn clean verify

预期结果是命令以成功状态结束,并在普通 JAR 工程中看到打包产物;实际插件版本、耗时与时间戳会不同。

text
[INFO] Building stage-demo 1.0.0
...
[INFO] BUILD SUCCESS

如果只想确认主代码能否编译,用 mvn compile 会更快;如果准备提交代码,mvn verify 通常比只跑 package 更稳妥,因为项目可能把集成测试、静态检查或其他质量门禁绑定在 package 之后、verify 之前。

package、verify、install、deploy 不要混用

package 的边界是“拿到制品”,不会把 JAR 自动放进本地 Maven 仓库;install 会写入本机仓库,典型路径是 ~/.m2/repository/<groupId 路径>/<artifactId>/<version>/。因此本地多工程联调常用 mvn install,单工程验证则优先停在 verify。

deploy 再向前一步,把制品上传到远程仓库。它依赖可用的仓库地址、认证信息以及项目或命令行中的部署配置,通常交给 CI 执行。没有这些条件时,直接运行 mvn deploy 常见结果是仓库未配置、认证失败或上传被拒绝,而不是“比 install 更完整的本地构建”。

选错阶段时用产物反查

如果执行 mvn test 后找不到 JAR,这是正常现象,因为 package 尚未到达;执行 mvn package 后另一个工程仍解析不到当前制品,也正常,因为本地仓库尚未写入。把“我需要看到什么结果”映射到最远阶段,比机械地每次执行 mvn clean install 更高效。

排查时可按这组边界检查:只看编译错误停在 compile,只跑单测停在 test,要文件停在 package,要完整验证停在 verify,要本地复用停在 install,要共享制品才使用 deploy。这样既减少无关副作用,也让失败发生在哪个阶段更容易定位。

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

目录与阅读设置

阅读设置

17

记录一个想法

常用构建阶段

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

登录哪都通