maven是java项目依赖管理的事实标准，需正确配置pom.xml坐标、scope和exclusions，设置阿里云镜像源，统一使用maven 3.8.1+版本并禁用ide内置版本。
用 Maven 管理依赖是当前 Java 项目的事实标准
如果你还在手动下载 .jar 文件、复制到 lib/ 目录、再逐个添加到 build path，那不仅容易出错，而且无法复现构建、难以协同。Maven（或 Gradle）才是现代 Java 项目依赖管理的正确起点。
pom.xml 中 <dependency></dependency> 的写法必须精确匹配坐标
常见错误是只写对了 groupId 和 artifactId，却忽略了 version 或用了 SNAPSHOT 版本却没配好仓库。更隐蔽的问题是：未声明 <scope></scope> 导致测试依赖打进生产包，或编译依赖在运行时报 NoClassDefFoundError。
关键点：
-
version推荐使用具体版本号（如1.12.5），避免LATEST或RELEASE（已弃用且不可控） - 测试用的依赖（如
junit-jupiter）应显式设<scope>test</scope> - 若依赖本身有传递性冲突（比如两个库都引了不同版的
guava），要用<exclusions></exclusions>排除
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-logging</artifactId>
</exclusion>
</exclusions>
</dependency>
本地仓库路径和镜像源配置直接影响下载成败
Maven 默认把依赖存到用户主目录下的 ~/.m2/repository。如果磁盘空间不足、权限不对、或路径含中文/空格，mvn clean compile 就会卡在 “Downloading…” 或报 Could not transfer artifact。
立即学习“Java免费学习笔记（深入）”；
国内项目务必配阿里云镜像——不是可选项，是刚需：
<mirror> <id>aliyunmaven</id> <mirrorOf>*</mirrorOf> <name>Aliyun Maven</name> <url>https://maven.aliyun.com/repository/public</url> </mirror>
该配置需写入 ~/.m2/settings.xml（若无则新建），不能只放在项目级 pom.xml 里。
IDE 同步失败时别急着重装插件，先检查 Maven 版本兼容性
IntelliJ 或 Eclipse 有时显示 “Dependencies not loaded” 或 “Maven projects need to be imported”，根源常是 IDE 内置 Maven 版本太老（比如 IDEA 自带 Maven 3.6.x），而你的 pom.xml 用了 <dependencymanagement></dependencymanagement> 中的 BOM 导入方式（Spring Boot 3+ 强依赖 Maven 3.8.1+）。
解决办法很直接：
- 在 IDE 设置中把 Maven home 改为本地安装的较新版本（如
/opt/maven） - 确认
mvn -v输出的版本 ≥ 3.8.1 - 执行
mvn dependency:tree -Dverbose手动验证依赖是否能解析成功，再回 IDE 刷新
真正麻烦的不是配置本身，而是不同层级（全局 settings、项目 pom、IDE 集成、CI 脚本）之间 Maven 行为不一致。建议所有团队成员统一用 SDKMAN! 或 brew 安装 Maven，并禁用 IDE 自带版本。
