构建与依赖 / 系统课时

dependencyManagement 的作用

dependencyManagement 的作用

dependencyManagement 用来集中规定依赖的版本和默认规则,但它本身不会把依赖加入项目。掌握这一点后,你可以让多个模块共享同一版本,又避免父 POM 把所有依赖强行塞进每个子模块。

学习目标

  • 区分 dependencyManagement 与 dependencies 的职责。
  • 在父 POM 中统一依赖版本,并让子模块省略 version。
  • 用 Maven 依赖树验证最终采用的版本。

先区分“管理版本”和“引入依赖”

假设项目有 6 个模块,其中 4 个都使用 commons-lang3。把版本写进 dependencyManagement,只是在模型里声明“如果某个模块需要它,默认使用 3.14.0”;真正让 JAR 进入编译类路径的仍然是 dependencies。

配置位置 会直接引入依赖 可以统一版本 子模块是否还要声明依赖
dependencies 会 可以,但会同时引入 不一定,父依赖通常会被继承
dependencyManagement 不会 会 要,需要时在 dependencies 中声明

根目录父 POM 可以这样集中管理版本:

xml
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.example</groupId>
  <artifactId>demo-parent</artifactId>
  <version>1.0.0</version>
  <packaging>pom</packaging>

  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>org.apache.commons</groupId>
        <artifactId>commons-lang3</artifactId>
        <version>3.14.0</version>
      </dependency>
    </dependencies>
  </dependencyManagement>
</project>

子模块只声明“我要这个依赖”,不再重复版本:

xml
<dependency>
  <groupId>org.apache.commons</groupId>
  <artifactId>commons-lang3</artifactId>
</dependency>

这样 4 个使用该库的模块都会采用 3.14.0,而另外 2 个没有声明它的模块不会凭空多出这项依赖。

用依赖树确认最终版本

在包含子模块 pom.xml 的目录执行:

bash
mvn dependency:tree -Dincludes=org.apache.commons:commons-lang3

预期输出中应出现 3.14.0;时间、插件日志和路径等动态信息可能不同。

text
[INFO] com.example:app:jar:1.0.0
[INFO] \- org.apache.commons:commons-lang3:jar:3.14.0:compile

如果这里没有 commons-lang3,说明子模块只受到了版本管理,却没有在 dependencies 中真正声明依赖。如果出现了其他版本,应继续检查子模块是否显式写了 version,或是否有更近层级的 dependencyManagement 覆盖了父配置。

版本覆盖要按层级判断

dependencyManagement 是默认规则,不是不可修改的锁。子模块显式声明 <version>3.13.0</version> 时,该直接依赖会按子模块写出的版本解析;子模块也可以在自己的 dependencyManagement 中重新管理同一坐标。

一个常见做法是:父 POM 管理公共版本,业务模块只在确有兼容性理由时覆盖,并在代码评审里说明原因。例如 6 个模块统一用 3.14.0,只有旧接口模块因第三方兼容要求暂时固定 3.13.0,这种偏离应是可追踪的例外。

什么时候应该放进 dependencyManagement

适合放进去的是多个模块可能共享、且版本需要统一的依赖,例如测试框架、日志 API、JSON 库和公司内部公共组件。一个 10 模块项目里,如果 7 个模块都用同一 JSON 库,把版本集中管理可以把升级操作从 7 处改成 1 处。

不适合的是只被单个模块临时使用、且没有跨模块版本协调需求的依赖。此时直接在该模块 dependencies 中写版本更直观。判断标准很简单:需要“统一版本”时用 dependencyManagement,需要“真正引入”时用 dependencies,两者可以同时存在但职责不能混淆。

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

目录与阅读设置

阅读设置

17

记录一个想法

dependencyManagement 的作用

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

登录哪都通