构建与依赖 / 系统课时
选择性构建指定模块
选择性构建指定模块
大型 Maven 工程没必要每次都全量执行。-pl 用来选择 Reactor 中的项目,-am 补上所选项目依赖的上游模块,-amd 补上下游依赖者。掌握三者的组合,就能在不破坏依赖关系的前提下把本地构建范围缩到真正受影响的模块。
学习目标
- 能用
-pl精确选择一个或多个模块,并理解选择器作用在当前 Reactor 内。 - 能正确区分
-am与-amd,按“需要上游”或“需要下游”决定构建集合。 - 能用 Reactor 日志核对实际参与模块,避免漏构建导致误判。
用 -pl 只选目标模块
假设工程有 core、service、app、docs 四个模块,依赖链是 app → service → core,docs 独立。只修改 docs 时,在根目录运行下面命令即可避免构建另外三个模块。
mvn -pl docs package预期结果:Reactor 本次只选择 docs 业务模块;构建成功时该模块进入 package 阶段,其余 core、service、app 不参与。
docs-pl 也可以一次选择多个模块,列表用逗号分隔,例如 mvn -pl service,docs test。相对目录选择器最直观,适合目录名与模块名一致的工程;在脚本里若要降低重命名目录带来的影响,可以改用 :artifactId 形式,例如 -pl :service。
需要上游依赖时加 -am
如果直接执行 mvn -pl app package,而 core、service 的新代码还没有安装进本地仓库,app 可能解析到旧构件或直接报依赖缺失。此时加 -am,让 Reactor 同时构建目标项目所依赖的上游模块。
mvn -pl app -am package预期结果:除可能参与的聚合父 POM 外,业务模块集合应包含 core、service、app,并按依赖顺序构建;独立的 docs 不参与。
core
service
app一个可直接套用的判断规则是:我要构建 A,而且 A 依赖的当前源码也必须一起生效,就用 -pl A -am。 这也是日常修改应用模块后最常见的局部构建方式。
修改底层模块时用 -amd
-amd 的方向与 -am 相反:它从已选择项目出发,把依赖这些项目的下游模块也加入。修改 core 后,希望验证所有直接或间接受影响的模块,可以运行:
mvn -pl core -amd test预期结果:业务模块会覆盖 core、service、app,因为后两者都位于 core 的下游;独立的 docs 不会进入 Reactor。
core
service
app注意 -amd 不负责补齐目标模块的上游依赖。如果选择的是中间层 service,而它还依赖未安装的 core 新版本,仅用 -amd 可能不够;需要根据目标把 -am 与 -amd 一起加上,再核对 Reactor 列表。
用构建集合衡量是否真的提速
不要只看命令短不短,要看 Reactor 最终选了多少模块。假设一次全量 test 实测 9 分 40 秒,其中 docs 40 秒、core 55 秒、service 2 分 10 秒、app 5 分 20 秒。只改 service 接口实现且要验证应用层时,mvn -pl service -amd test 会跳过独立 docs;若还需要当前 core 源码,则改为 mvn -pl service -am -amd test。
选择性构建最容易犯的错是把“构建成功”当成“验证完整”。改动公共底层模块时,至少覆盖所有受影响下游;只改孤立模块时才适合单独 -pl。用依赖方向决定 -am 或 -amd,比记命令组合更可靠。