必须指向本地Maven并修改settings.xml，因IDEA内置版本不加载自定义镜像和仓库路径配置，仅靠IDEA界面设置无法生效；需解压Maven至纯英文路径，在settings.xml中配置<localRepository>和<aliyunmaven>镜像，并重启IDEA后执行Reload project验证。
IntelliJ IDEA 本身不“安装” Maven，它只配置使用已安装的 Maven —— 直接用 Bundled（内置）版本最省事，但想控制仓库路径、镜像源或复用已有配置，就必须指向本地解压好的 Maven 并手动配 settings.xml。
为什么不能跳过本地 Maven 解压和 settings.xml 修改
IDEA 的 Bundled Maven 默认读取用户目录下的 ${user.home}/.m2/repository，且不加载你自定义的镜像配置。一旦项目依赖多（比如 Hadoop 生态），默认中央仓库下载慢、易超时、常失败。你看到的 Could not transfer artifact 或 Connection refused 错误，90% 源于没改 settings.xml 中的 <mirror></mirror> 和 <localrepository></localrepository>。
- 必须解压 Maven 到纯英文路径（如
D:/maven/apache-maven-3.8.1），避免空格和中文 -
settings.xml要改两处：取消注释并写死<localrepository></localrepository>（如D:/maven/repository），再在<mirrors></mirrors>里加阿里云镜像 - 不改
settings.xml，只在 IDEA 里填对 Maven 路径，镜像和仓库路径依然无效
MAVEN_HOME 和 PATH 环境变量要不要配
对 IDEA 来说，MAVEN_HOME 和 PATH 不是必需的 —— IDEA 启动时并不读系统环境变量来定位 Maven。但它们影响命令行行为：
- 如果你习惯在 IDEA Terminal 里敲
mvn clean install，没配环境变量会报'mvn' is not recognized - 配了
MAVEN_HOME后，还能顺手加MAVEN_OPTS=-Xmx1024m防止大项目编译时 OOM - Windows 下建议配：
MAVEN_HOME = D:\maven\apache-maven-3.8.1，PATH加%MAVEN_HOME%\bin
IDEA 里三处关键配置不能漏
打开 File → Settings → Build, Execution, Deployment → Build Tools → Maven 后，以下三项必须核对：
-
Maven home directory：选你解压的完整路径（如D:/maven/apache-maven-3.8.1），别选 Bundled -
User settings file：勾选 “Use settings from file”，路径指向你改过的settings.xml（如D:/maven/apache-maven-3.8.1/conf/settings.xml） -
Local repository：这项可留空 —— 只要上面指定了settings.xml，IDEA 就会自动读取其中的<localrepository></localrepository>值，填重复反而容易冲突
验证是否真生效的两个硬指标
改完别急着新建项目，先看这两个地方：
- 打开 IDEA Terminal，执行
mvn help:effective-settings，输出里必须出现你设的localRepository路径和aliyunmaven镜像 ID - 新建一个最简 Maven 项目（
archetypeGroupId=org.apache.maven.archetypes,archetypeArtifactId=maven-archetype-quickstart），等依赖下载完，去你指定的repository文件夹下搜junit，能看到类似org/junit/jupiter/junit-jupiter-api/5.9.2/这样的层级，说明本地仓库已写入
最容易被忽略的是：IDEA 导入项目时默认勾选 “Import Maven projects automatically”，但它不会重新读 settings.xml —— 如果你中途改过镜像或仓库路径，必须点右上角 Maven 工具窗口里的 Reload project 图标，否则缓存的旧配置还在起作用。
