Maven和Gradle是Java项目事实标准依赖管理工具，选择取决于团队、生态与构建需求：Maven适合稳定企业级项目，IDE支持成熟但XML冗长；Gradle构建灵活但插件配置易错；Spring Boot中Maven版本对齐更显式，Gradle需dependencyManagement插件补全。
Java 项目里不配好依赖管理工具，等于没开工——Maven 和 Gradle 不是可选项，是事实标准。选哪个不关键，关键是配置不能出错，否则连 java.lang.NoClassDefFoundError 都查不到源头。
用 Maven 还是 Gradle？看这三点再决定
不是看谁新，而是看团队、生态和构建需求：
-
Maven：适合企业级稳定项目，pom.xml结构固定，IDE（如 IntelliJ、Eclipse）支持最成熟，中央仓库索引最全；但 XML 写法冗长，自定义构建逻辑难写 -
Gradle：适合需要灵活构建脚本的项目（比如多模块打包成不同 fat-jar、条件化资源过滤），build.gradle用 Groovy 或 Kotlin 写，DSL 更直观；但新手容易误配plugins块顺序，导致插件未生效 - 如果用 Spring Boot，官方脚手架默认生成两者，但
spring-boot-starter-parent的版本对齐在Maven中更显式，在Gradle中得靠dependencyManagement插件补全
pom.xml 里 scope 写错，编译过、运行崩
scope 不是“可有可无”的修饰，它直接决定类路径（classpath）行为：
-
compile（默认）：参与编译、测试、运行，打包进lib/（非 shade 模式下） -
provided：只参与编译和测试，**不打入最终包**——典型用于servlet-api，因为容器（Tomcat）已提供；写成compile会导致冲突或 ClassLoader 异常 -
test：仅测试期可用，比如junit、mockito-core；误设为compile会让测试代码泄漏到生产包中 -
runtime：不参与编译，只在运行时需要，比如 JDBC 驱动（mysql-connector-java）；但注意 JDK 11+ 默认不带javax.xml.bind，需显式加runtime依赖jakarta.xml.bind-api
Gradle 的 dependency block 里 version 冲突怎么解
Gradle 不像 Maven 那样强制继承 parent 版本管理，多个库间接引入同一依赖的不同版，就会触发 Could not resolve all files for configuration ':compileClasspath' 类错误：
立即学习“Java免费学习笔记（深入）”；
- 优先用
platform或bom统一版本，例如 Spring Boot 项目应声明：dependencies { implementation platform('org.springframework.boot:spring-boot-dependencies:3.2.5') } - 手动强制指定版本（不推荐长期用）：
configurations.all { resolutionStrategy { force 'org.slf4j:slf4j-api:2.0.12' force 'com.fasterxml.jackson.core:jackson-databind:2.15.2' } } - 查冲突根源：运行
./gradlew dependencies --configuration compileClasspath，看树形输出里哪个路径拉进了旧版
本地 jar 包怎么加进 Maven/Gradle？别硬拷进 lib
把 .jar 文件扔进项目目录再手动添加到 classpath，是反模式——CI/CD 会失败，协作时别人跑不起来：
- Maven：用
systemscope 是临时方案，但不上传、不解析传递依赖，且 Maven 3.8.1+ 已弃用；正确做法是用mvn install:install-file推到本地仓库：mvn install:install-file \ -Dfile=lib/legacy-sdk-1.0.jar \ -DgroupId=com.example \ -DartifactId=legacy-sdk \ -Dversion=1.0 \ -Dpackaging=jar
- Gradle：避免
files('lib/xxx.jar')，改用flatDir（不推荐）或更稳妥的maven { url './repo' }，把 jar 放进./repo/com/example/legacy-sdk/1.0/legacy-sdk-1.0.jar，再声明implementation 'com.example:legacy-sdk:1.0'
真正麻烦的从来不是“怎么加依赖”，而是“为什么这个依赖在测试里有、运行时报 NoClassDefFoundError”——多半是 scope、classloader 层级或构建产物过滤惹的祸。多看 ./gradlew dependencies 或 mvn dependency:tree -Dverbose，比反复 clean-rebuild 有用得多。
