IDEA中Maven仓库路径未生效需检查settings.xml加载顺序：必须勾选“Override”、确认localRepository路径可写、重载项目，并验证effective-settings；常见原因包括插件绕过配置、缓存旧路径、多模块配置不一致及Windows路径含空格等。
IDEA 里 Maven 仓库路径没生效？先查 settings.xml 加载顺序
IDEA 默认不读取你手动配置的 settings.xml，它优先用内置的（~/.m2/settings.xml 或 IDEA 自带的 bundled 配置），哪怕你在 File → Settings → Build → Maven 里指定了路径，也可能被忽略。
实操建议：
- 在 IDEA 中打开
Settings → Build → Maven → User settings file，**必须勾选 “Override”**，否则路径设置无效 - 确认该
settings.xml文件中<localRepository>标签存在且路径可写（比如/Users/xxx/.m2/repository-local） - 改完后点
Reload project（右键项目 →Reload project），不是只点Reimport - 验证是否生效：打开终端，执行
mvn help:effective-settings，看输出里的localRepository是否为你指定的路径
为什么 IDEA 显示依赖下载到了 ~/.m2/repository，但 settings.xml 明明写了别的路径？
常见原因是 Maven 插件（尤其是 maven-dependency-plugin 或某些第三方插件）在运行时绕过了全局 settings.xml，直接用了默认本地仓库路径；或者 IDEA 的 Maven import 过程缓存了旧配置。
实操建议：
- 关闭 IDEA，删掉项目根目录下的
.idea/misc.xml和.idea/workspace.xml（它们可能硬编码了旧仓库路径） - 检查
pom.xml中是否有<build><plugins><plugin>块里显式设置了-Dmaven.repo.local=...参数 - 在 IDEA 终端执行
mvn -X clean compile 2>&1 | grep "local repository"，看 Maven 实际加载的是哪个路径 - 如果用的是 M1/M2 Mac，注意
~在 shell 和 IDEA JVM 启动环境里解析可能不一致，建议用绝对路径（如/Users/xxx/.m2/repo-custom）
多模块项目下，子模块的 mvn install 仍往默认仓库写？
这是因为 mvn install 默认把构建产物安装到 localRepository，但如果你在父 POM 里没统一约束，各子模块可能各自解析自己的 settings.xml 或继承了 IDEA 的默认行为。
实操建议：
- 确保所有模块共用同一份
settings.xml（推荐放在项目根目录，然后在 IDEA 中显式指向它） - 在父
pom.xml中添加<properties><maven.repo.local>/path/to/custom/repo</maven.repo.local></properties>，部分插件会识别这个属性 - 执行命令时加参数强制指定：
mvn clean install -Dmaven.repo.local=/path/to/custom/repo - 避免在子模块
pom.xml中写死<distributionManagement>，它和本地仓库无关，但容易干扰判断
Windows 下路径含空格或中文导致仓库不可写？
是的，Maven 3.8+ 对路径合法性校验更严格，IDEA 启动时若 JVM 参数或系统环境变量里有空格未转义，settings.xml 解析失败，就会退回到默认路径。
实操建议：
- 把本地仓库路径设为纯英文、无空格、无中文，例如
C:/dev/m2-repo，不要用C:/Users/张三/.m2/repository - 检查 IDEA 的
Help → Edit Custom VM Options，确认没有类似-Dmaven.home="C:\Program Files\..."这种带空格未引号包裹的配置 - 在
settings.xml中用双反斜杠或正斜杠：<localRepository>C:/dev/m2-repo</localRepository>（Windows 下正斜杠完全合法） - 启动 IDEA 后，打开
Help → Diagnostic Tools → Debug Log Settings，输入org.apache.maven，重启看日志里有没有Failed to parse settings.xml
最常被忽略的一点：IDEA 的 Maven 配置分“Project-level”和“Global-level”，修改位置不对就白调。每次改完务必点右下角弹出的 Import changes，而不是等它自动同步。
