构建与依赖 / 系统课时
常用构建阶段
常用构建阶段
Maven 日常最常见的七个阶段是 validate、compile、test、package、verify、install 和 deploy。关键规则只有一条:调用默认生命周期中较后的阶段时,Maven 会先按顺序执行它之前的阶段,因此通常不需要把每个阶段都写在命令行里。
学习目标
- 说清七个常用阶段各自产生什么结果。
- 根据“只执行到最远目标阶段”的规则选择构建命令。
- 区分
package、verify、install、deploy的边界和副作用。
用最远阶段决定执行范围
对于默认生命周期,执行 mvn verify 时会先经过 validate、编译、测试、打包以及集成测试相关阶段,再到 verify;执行 mvn install 还会继续把制品写入本地仓库。下面这张图适合直接作为命令选择表来读。

| 阶段 | 你可以直接检查的结果 | 适合什么时候调用 |
|---|---|---|
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。
mvn clean verify预期结果是命令以成功状态结束,并在普通 JAR 工程中看到打包产物;实际插件版本、耗时与时间戳会不同。
[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。这样既减少无关副作用,也让失败发生在哪个阶段更容易定位。