构建与依赖 / 系统课时

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 改写。

package 到本地仓库的 install 数据流

先在库项目目录执行:

bash
mvn clean install

预期输出的关键结果如下,<PATH> 和耗时会随机器变化:

text
[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 实际使用哪个本地仓库,可执行:

bash
mvn help:evaluate -Dexpression=settings.localRepository -q -DforceStdout

预期输出:

text
<PATH>/.m2/repository

因此不要只盯着默认目录排查;公司脚本、CI 或命令行参数都可能让构建使用另一套仓库。

在另一个项目中复用本地产物

消费方不需要写 systemPath,也不需要把 JAR 手工复制进 lib/。只要它与库项目使用同一个本地仓库,就按正常依赖声明坐标。下面是放入消费方 pom.xml 的片段示例:

xml
<dependency>
  <groupId>com.example</groupId>
  <artifactId>pricing-core</artifactId>
  <version>1.0.0-SNAPSHOT</version>
</dependency>

这段配置生效后,Maven 会先在本地仓库中寻找对应坐标。可在消费方目录执行:

bash
mvn dependency:tree -Dincludes=com.example:pricing-core

预期输出的关键结果:

text
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 在不同人机器上内容不同”会让问题很难复现。

需要隔离本地仓库时,可以显式指定目录:

bash
mvn -Dmaven.repo.local=<PATH>/isolated-repo clean install

预期输出的关键结果:

text
[INFO] BUILD SUCCESS

消费方若也要看到这份制品,就必须使用同一个 -Dmaven.repo.local=<PATH>/isolated-repo。这也是容器和 CI 中常见的差异来源:开发机已经 install 过,并不代表另一个构建环境拥有同一份本地缓存。

什么时候应该改用 deploy

install 只解决单机复用,不会把制品发布给团队。若另一个开发者、CI Runner 或部署环境需要获取该制品,应把版本发布到远程 Maven 仓库,再由各环境正常解析。一个直接判断标准是:只在当前机器联调,用 install;需要跨机器、可追溯、可重复获取,就进入 deploy 发布流程。

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

目录与阅读设置

阅读设置

17

记录一个想法

install 与本地制品复用

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

登录哪都通