构建与依赖 / 系统课时
install 与本地制品复用
install 与本地制品复用
mvn install 解决的是“当前机器上的另一个 Maven 项目怎样直接使用我刚构建的库”。它会先完成测试与打包,再把项目 POM、主制品以及已附加制品写入本地仓库,使相同本地仓库下的其他构建可按普通依赖坐标解析。
学习目标
- 说清
package与install的差别,并定位制品在本地仓库中的实际路径。 - 能把一个本地构建的 JAR 作为普通依赖引入另一个 Maven 项目。
- 能处理 SNAPSHOT 复用、不同本地仓库和“本机能构建、CI 不能构建”这类问题。
install 阶段写入了什么
假设库项目坐标是 com.example:pricing-core:1.0.0-SNAPSHOT。mvn package 主要把 JAR 留在当前项目的 target/;mvn install 继续执行 install 阶段,把 JAR 和 POM 写入 Maven 本地仓库。默认仓库通常是用户目录下的 .m2/repository,也可以由 settings.xml 的 localRepository 改写。

先在库项目目录执行:
mvn clean install预期输出的关键结果如下,<PATH> 和耗时会随机器变化:
[INFO] Installing <PATH>/target/pricing-core-1.0.0-SNAPSHOT.jar to <PATH>/.m2/repository/com/example/pricing-core/1.0.0-SNAPSHOT/pricing-core-1.0.0-SNAPSHOT.jar
[INFO] BUILD SUCCESS如果不确定当前 Maven 实际使用哪个本地仓库,可执行:
mvn help:evaluate -Dexpression=settings.localRepository -q -DforceStdout预期输出:
<PATH>/.m2/repository因此不要只盯着默认目录排查;公司脚本、CI 或命令行参数都可能让构建使用另一套仓库。
在另一个项目中复用本地产物
消费方不需要写 systemPath,也不需要把 JAR 手工复制进 lib/。只要它与库项目使用同一个本地仓库,就按正常依赖声明坐标。下面是放入消费方 pom.xml 的片段示例:
<dependency>
<groupId>com.example</groupId>
<artifactId>pricing-core</artifactId>
<version>1.0.0-SNAPSHOT</version>
</dependency>这段配置生效后,Maven 会先在本地仓库中寻找对应坐标。可在消费方目录执行:
mvn dependency:tree -Dincludes=com.example:pricing-core预期输出的关键结果:
com.example:pricing-core:jar:1.0.0-SNAPSHOT:compile
BUILD SUCCESS如果这里显示无法解析依赖,先核对三件事:库项目执行 install 是否成功、两边的 groupId/artifactId/version 是否逐字一致、两边是否使用同一个本地仓库。
处理版本覆盖和本地仓库差异
开发中的本地联调更适合使用 1.0.0-SNAPSHOT 这类版本。你可以修改库代码后再次执行 mvn install,消费方下一次构建会读取本地仓库里更新后的 SNAPSHOT。不要长期用固定 release 版本反复覆盖本机文件,否则“同一个 1.0.0 在不同人机器上内容不同”会让问题很难复现。
需要隔离本地仓库时,可以显式指定目录:
mvn -Dmaven.repo.local=<PATH>/isolated-repo clean install预期输出的关键结果:
[INFO] BUILD SUCCESS消费方若也要看到这份制品,就必须使用同一个 -Dmaven.repo.local=<PATH>/isolated-repo。这也是容器和 CI 中常见的差异来源:开发机已经 install 过,并不代表另一个构建环境拥有同一份本地缓存。
什么时候应该改用 deploy
install 只解决单机复用,不会把制品发布给团队。若另一个开发者、CI Runner 或部署环境需要获取该制品,应把版本发布到远程 Maven 仓库,再由各环境正常解析。一个直接判断标准是:只在当前机器联调,用 install;需要跨机器、可追溯、可重复获取,就进入 deploy 发布流程。