Maven 依赖管理

Maven 依赖管理

---

1. 核心概念解析

1.1 dependencyManagement

• 作用：仅用于统一管理依赖的版本号，不直接引入依赖。
• 使用场景：多模块项目中，父 POM 统一管理子模块依赖版本，避免冲突和重复配置。
• 特点：
  • 子模块需显式在 <dependencies> 中声明依赖（无需版本号）才能生效。
  • 可覆盖父 POM 的版本（子模块手动指定版本）。

1.2 dependencies

• 作用：直接引入依赖，依赖会自动下载并加入构建路径（如 classpath）。
• 特点：
  • 若未指定版本号，Maven 会尝试解析最新版本（可能导致不一致）。
  • 单模块项目通常直接在此声明依赖。

---

2. 是否需要同时写在 dependencyManagement 和 dependencies？

场景	操作方式	示例
父 POM 统一管理版本	1. 父 POM 在 <dependencyManagement> 声明版本 2. 子模块在 <dependencies> 声明依赖（无需版本号）

<!-- 父 POM -->
<dependencyManagement><dependencies><dependency><groupId>org.springframework</groupId><artifactId>spring-core</artifactId><version>5.3.10</version></dependency></dependencies>
</dependencyManagement><!-- 子模块 -->
<dependencies><dependency><groupId>org.springframework</groupId><artifactId>spring-core</artifactId><!-- 无需版本号 --></dependency>
</dependencies>

|
| 直接引入依赖 | 仅在 <dependencies> 声明依赖（需指定版本号） |

<dependencies><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.13.2</version></dependency>
</dependencies>

|
| 覆盖父 POM 版本 | 子模块在 <dependencies> 中显式指定新版本 |

<dependencies><dependency><groupId>org.springframework</groupId><artifactId>spring-core</artifactId><version>5.3.20</version> <!-- 覆盖父 POM 版本 --></dependency>
</dependencies>

|

---

3. 总结对比表

场景	是否需要写在 dependencyManagement？	是否需要写在 dependencies？
父 POM 统一管理版本	✅ 是（声明版本）	子模块 ✅ 是（无需版本号）
直接引入依赖	❌ 否	✅ 是（需指定版本号）
覆盖父 POM 版本	❌ 否	✅ 是（需显式指定新版本）

---

4. 最佳实践

1. 多模块项目：
   • 父 POM 使用 <dependencyManagement> 统一版本。
   • 子模块在 <dependencies> 中声明依赖（无需版本号）。
2. 单模块项目：
   • 直接在 <dependencies> 中声明依赖（需版本号）。
3. 避免版本冲突：
   • 通过 <dependencyManagement> 统一版本，确保依赖一致性。
4. 灵活覆盖：
   • 子模块可通过 <dependencies> 覆盖父 POM 的版本。

---

5. 示例代码

父 POM（管理版本）

<dependencyManagement><dependencies><dependency><groupId>org.springframework</groupId><artifactId>spring-core</artifactId><version>5.3.10</version></dependency></dependencies>
</dependencyManagement>

子模块（引入依赖）

<dependencies><dependency><groupId>org.springframework</groupId><artifactId>spring-core</artifactId><!-- 自动继承父 POM 的版本 --></dependency>
</dependencies>

---

6. 注意事项

• 版本优先级：子模块在 <dependencies> 中显式指定的版本会覆盖父 POM 的 <dependencyManagement>。
• 避免冗余：若依赖版本无需统一管理，无需写入 <dependencyManagement>。
• 作用范围：<dependencyManagement> 仅管理版本，依赖仍需在 <dependencies> 中声明才能使用。

---