IDEA默认不读取系统Maven的conf/settings.xml，而使用自动生成的$USER_HOME/.m2/settings.xml或内置副本；必须在Settings→Build Tools→Maven中手动指定User settings file路径并同步Local repository和Active profiles才能生效。
IDEA里Maven用的是哪个settings.xml？
IDEA默认不读取你系统 Maven 安装目录下的 conf/settings.xml，而是用它自己生成的一份（路径类似 $USER_HOME/.m2/settings.xml 或 IDEA 内置副本），除非你明确告诉它用哪一份。
常见错误现象：mirror 配了但没生效、私有仓库认证失败、profiles 激活不了——八成是 IDEA 根本没加载你改的那版 settings.xml。
- 进 File → Settings → Build → Build Tools → Maven（macOS 是 IntelliJ IDEA → Preferences）
- 看
User settings file这一项：必须手动点击…选中你真实修改过的settings.xml，不能只改Maven home path - 如果勾了
Override settings却没填路径，IDEA 会静默 fallback 到默认配置，不会报错也不会提醒
本地仓库路径怎么和settings.xml对齐？
settings.xml 里 <localRepository> 的值，和 IDEA 里 Local repository 字段必须一致，否则会出现“依赖下载到了A路径，但编译时去B路径找”的错乱。
使用场景：多人协作项目统一仓库位置、SSD/HDD 分盘存放、CI 环境复现本地构建行为。
- 先确认
settings.xml中已写明：<localRepository>/path/to/your/local/repo</localRepository>
- 在 IDEA 的 Maven 设置页，把
Local repository手动改成**完全相同的路径**（不要依赖自动填充） - 改完后点
Reload project，观察右下角是否弹出 “Importing Maven project…” —— 没弹说明没生效 - Windows 用户注意路径分隔符：用正斜杠
/或双反斜杠\，单反斜杠会导致路径解析失败
为什么改了settings.xml，IDEA还是连不上私有Nexus？
不是配置写错了，大概率是 IDEA 没用上你配的 <servers> 凭据，或者 profile 没激活。
关键点：IDEA 不自动激活 settings.xml 里的 <activeProfiles>，哪怕你写了 <activeByDefault>true</activeByDefault> 也没用。
- 确保
servers的id和mirrors或profiles中用到的id**严格一致**（大小写敏感） - 在 IDEA Maven 设置页，找到
Active profiles输入框，手动填入你要激活的 profile 名（如nexus-prod），多个用英文逗号分隔 - 密码建议用 Maven 的
mvn --encrypt-password加密后填入<password>，明文放settings.xml有风险且某些版本 IDEA 会忽略 - 检查 IDEA 底部状态栏有没有显示 “Maven projects need to be imported” —— 有就点它，别跳过
命令行 mvn 正常，IDEA 报错 “Could not resolve dependencies”
这是最典型的环境不一致问题：IDEA 启动时用的 JDK、MAVEN_OPTS、甚至 shell 环境变量，都可能和终端不同。
性能影响：IDEA 默认用内置 Maven 启动器，不走你终端的 PATH，所以即使你 which mvn 输出正确，IDEA 也可能根本没调用它。
- 在 IDEA Maven 设置页，确认
Maven home path指向你系统安装的 Maven（如/opt/homebrew/Cellar/maven/3.9.6），而不是 IDEA 自带的bundled版本 - 检查
Maven runner → VM options：如果你在终端设置了MAVEN_OPTS=-Xmx2g，这里得手动补上，否则大项目容易 OOM - IDEA 的 Maven import 是异步的，有时改完配置要关掉项目再重新 Open，仅 Reload 不够
- 遇到奇怪的依赖冲突，直接看 IDEA 控制台输出的完整
mvn命令，复制出来在终端执行，对比输出差异
真正麻烦的从来不是路径填错，而是 IDEA 和终端用了两套独立的 Maven 生命周期上下文——它们看起来一样，其实各自维护着不同的插件版本缓存、解析器状态和网络连接池。
