当前位置：首页 > article >正文

Maven 和 Gradle 依赖管理的详细说明及示例，涵盖核心概念、配置方法、常见问题解决和工具对比。

article 2025/8/26 11:40:37

一、Maven 依赖管理

1. 核心概念

依赖声明：在 pom.xml 中通过 <dependency> 标签定义依赖项，包含 groupId、artifactId、version。
仓库：依赖下载的来源，包括中央仓库（Maven Central）、私有仓库（如 Nexus、Artifactory）。
依赖范围（Scope）：控制依赖在不同阶段的可见性，如 compile（默认）、test、provided、runtime。
依赖传递：自动引入传递性依赖，可通过 <exclusions> 手动排除。

2. 依赖配置示例

(1) 基本依赖声明

xml

复制

<!-- pom.xml -->
<dependencies><!-- Spring Core 依赖 --><dependency><groupId>org.springframework</groupId><artifactId>spring-core</artifactId><version>5.3.20</version><scope>compile</scope> <!-- 默认可省略 --></dependency><!-- JUnit 测试依赖 --><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.13.2</version><scope>test</scope></dependency>
</dependencies>

(2) 仓库配置

xml
复制

<repositories><!-- 中央仓库（默认已配置，无需显式声明） --><repository><id>central</id><url>https://repo.maven.apache.org/maven2</url></repository><!-- 私有仓库 --><repository><id>company-nexus</id><url>http://nexus.company.com/repository/maven-public/</url><releases><enabled>true</enabled></releases><snapshots><enabled>true</enabled></snapshots></repository>
</repositories>

(3) 依赖范围与排除

xml
复制

<!-- 仅编译时可用，不打包到最终产物 -->
<dependency><groupId>javax.servlet</groupId><artifactId>javax.servlet-api</artifactId><version>4.0.1</version><scope>provided</scope>
</dependency><!-- 排除传递性依赖 -->
<dependency><groupId>com.example</groupId><artifactId>lib-a</artifactId><version>1.0.0</version><exclusions><exclusion><groupId>org.unwanted</groupId><artifactId>unwanted-lib</artifactId></exclusion></exclusions>
</dependency>

3. 依赖管理（Dependency Management）

在父 POM 中统一管理依赖版本：

xml

复制

<dependencyManagement><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-dependencies</artifactId><version>2.7.0</version><type>pom</type><scope>import</scope></dependency></dependencies>
</dependencyManagement>

二、Gradle 依赖管理

1. 核心概念

依赖配置：通过 dependencies 块定义，支持多种配置（如 implementation、api、testImplementation）。
仓库：支持 Maven Central、Ivy、自定义仓库（如 GitHub Packages）。
动态版本：支持 1.0.+ 表示最新兼容版本。
依赖解析策略：可自定义版本冲突解决规则。

2. 依赖配置示例

(1) 基本依赖声明（Groovy DSL）

groovy

复制

// build.gradle
plugins {id 'java'
}repositories {mavenCentral()// 私有仓库maven {url 'http://nexus.company.com/repository/maven-public/'}
}dependencies {// 编译时依赖implementation 'org.springframework:spring-core:5.3.20'// 测试依赖testImplementation 'junit:junit:4.13.2'// 排除传递性依赖implementation('com.example:lib-a:1.0.0') {exclude group: 'org.unwanted', module: 'unwanted-lib'}
}

(2) 依赖配置类型

配置名称	用途
`implementation`	编译和运行时依赖（默认）
`api`	暴露给其他模块的依赖（类似 Maven `compile`）
`testImplementation`	仅测试代码依赖
`runtimeOnly`	仅运行时需要，编译时不需要

(3) 依赖版本管理

groovy

复制

// 统一管理版本号
ext {springVersion = '5.3.20'
}dependencies {implementation "org.springframework:spring-core:${springVersion}"
}

(4) 动态版本与变更日志

groovy

复制

// 动态版本（慎用，可能导致不稳定）
dependencies {implementation 'com.example:lib-b:1.0.+'
}// 指定版本范围
dependencies {implementation 'com.example:lib-c:[1.0, 2.0)'
}

三、Maven vs Gradle 对比

特性	Maven	Gradle
配置语法	XML（冗长、不灵活）	Groovy/Kotlin DSL（简洁、灵活）
依赖管理	静态依赖，无动态版本支持	动态版本、自定义解析策略
构建速度	较慢（无增量构建）	快（增量构建、缓存机制）
扩展性	插件有限，配置复杂	支持自定义任务和灵活脚本
多模块项目	需手动配置父 POM	天然支持复合构建

四、常见依赖问题解决

1. 依赖冲突

Maven：使用 mvn dependency:tree 查看依赖树，通过 <exclusions> 排除冲突依赖。
Gradle：运行 gradle dependencies 查看依赖树，使用 exclude 或强制指定版本：
```
groovy
```
复制
```
configurations.all {resolutionStrategy.force 'org.apache.commons:commons-lang3:3.12.0'
}
```