Java项目依赖管理核心是使用Maven或Gradle工具，通过声明式配置自动处理下载、版本冲突、依赖范围与传递依赖，替代易出错的手动JAR管理；二者均需显式声明版本、定期检查依赖树、避免污染，并将依赖视为代码同等维护。
Java项目中管理第三方依赖，核心是用好依赖管理工具。Maven 和 Gradle 是目前最主流的两个选择，它们不仅能自动下载、组织和传递依赖，还能解决版本冲突、控制依赖范围、复用构建逻辑，让项目更稳定、协作更高效。
为什么必须用依赖管理工具？
手动下载 JAR 包再复制到 lib 目录的方式早已过时——容易遗漏传递依赖、难以统一版本、无法精准控制测试或编译期依赖、团队协作时极易不一致。依赖管理工具通过声明式配置（如 pom.xml 或 build.gradle），把“要用什么”和“怎么用”明确写下来，工具自动完成解析、下载、隔离与组装。
Maven：基于 XML 的标准实践
Maven 以约定优于配置为理念，pom.xml 是唯一入口。关键点包括：
-
坐标定义清晰：每个依赖由
groupId、artifactId、version唯一标识，例如org.springframework.boot:spring-boot-starter-web:3.2.0 -
依赖范围（scope）决定生命周期：常用
compile（默认，编译+运行）、test（仅测试阶段）、provided（如 Servlet API，容器已提供）、runtime（如 JDBC 驱动） -
依赖调解机制自动处理冲突：Maven 按“路径最近优先”和“先声明优先”规则选版本；可用
<exclusions>排除不需要的传递依赖 - 中央仓库 + 私服协同：默认从 Maven Central 下载；企业常部署 Nexus 或 Artifactory，统一代理、缓存并托管内部构件
Gradle：灵活可编程的现代选择
Gradle 使用 DSL（Groovy 或 Kotlin）编写构建脚本，比 Maven 更灵活，适合复杂定制场景：
立即学习“Java免费学习笔记（深入）”；
-
声明简洁直观：Kotlin DSL 示例：
implementation("com.fasterxml.jackson.core:jackson-databind:2.15.2") -
依赖配置（Configuration）替代 scope：如
implementation（编译+运行）、testImplementation（仅测试）、compileOnly（仅编译） -
支持依赖约束（dependency constraints）：在
dependencies块中统一锁定版本，避免子模块各自声明导致不一致 - 构建缓存与增量编译提升效率：尤其适合大型多模块项目，重复构建时跳过未变部分
实用建议与避坑提醒
无论选 Maven 还是 Gradle，以下几点直接影响项目健康度：
-
始终显式声明版本，避免使用
LATEST或RELEASE：这些动态版本不可重现，CI/CD 中可能拉取不同结果 -
定期执行依赖检查：Maven 可用
mvn dependency:tree -Dverbose查看全量依赖树；Gradle 执行./gradlew dependencies；配合mvn versions:display-dependency-updates或 Gradle Versions Plugin 检查更新 -
警惕依赖污染：避免在
compile或implementation中引入测试类库（如mockito-core），应归入对应测试配置 -
多模块项目注意依赖可见性：Maven 中子模块默认不继承父模块的
dependencies，需显式声明；Gradle 中可通过api/implementation控制是否向下游暴露依赖
不复杂但容易忽略。把依赖当作代码的一部分来维护——写清楚、审得严、更新有据，项目才真正可控、可演进、可交付。
