Maven 使用 `dependencyManagement` 管理依赖版本

使用 dependencyManagement 管理依赖版本

背景

在多模块 Maven 项目中，管理依赖的版本是一个常见的需求。为了确保所有子模块使用一致的依赖版本，并且避免在每个子模块中重复声明版本号，Maven 提供了 <dependencyManagement> 元素。通过在父项目的 pom.xml 中集中管理依赖版本，可以简化子模块的配置并提高维护效率。

示例代码解释

<dependencyManagement>
    <dependencies>
        <!-- one-entity -->
        <dependency>
            <groupId>com.snackpub.one</groupId>
            <artifactId>one-entity</artifactId>
            <version>${one-plus.version}</version>
        </dependency>
    </dependencies>
</dependencyManagement>

这段代码的作用是为 one-entity 依赖指定一个版本管理规则。具体来说：

• <dependencyManagement>：用于集中管理依赖的版本、范围和其他配置。
• <dependencies>：包含一组依赖项，这些依赖项的版本将由父项目统一管理。
• <dependency>：定义了一个具体的依赖项。
  • <groupId>：依赖的组 ID，通常是组织或公司名称。
  • <artifactId>：依赖的工件 ID，通常是项目名称。
  • <version>：依赖的版本号，这里使用了变量 ${one-plus.version}，该变量可以在父项目的属性部分定义。

使用方法

1. 在父项目中定义依赖管理： 在父项目的 pom.xml 文件中，使用 <dependencyManagement> 来集中管理依赖版本。这样做的好处是，所有子模块都可以继承这些依赖管理规则，而不需要重复声明版本号。

2. 在子模块中引用依赖： 子模块只需要在自己的 pom.xml 文件中声明依赖，而不需要指定版本号。Maven 会自动从父项目的 <dependencyManagement> 中获取版本信息。

   <dependencies>
       <dependency>
           <groupId>com.snackpub.one</groupId>
           <artifactId>one-entity</artifactId>
       </dependency>
   </dependencies>
   

3. 定义版本属性（可选）： 如果需要动态管理版本号，可以在父项目的 pom.xml 中定义版本属性。例如：

   <properties>
       <one-plus.version>1.0.0-SNAPSHOT</one-plus.version>
   </properties>
   

4. 覆盖版本（可选）： 如果某个子模块需要使用不同版本的依赖，可以在子模块的 pom.xml 中重新声明该依赖并指定版本号。这将覆盖父项目中的版本管理规则。

总结

通过使用 <dependencyManagement>，可以有效地管理和统一多模块项目中的依赖版本，减少重复配置，提高项目的可维护性。父项目集中管理依赖版本，子模块只需声明依赖即可，简化了配置过程。同时，使用版本属性和覆盖机制可以灵活应对不同的开发需求。