必须同时完成三件事：正确安装Maven、配置阿里云镜像加速下载、绑定项目所需的JDK版本；缺一不可，否则mvn clean compile会卡在Downloading或报编译错误。

要在Windows系统上让Maven项目编译不报错、依赖下载不卡死，必须同时完成三件事：正确安装Maven、把默认中央仓库换成阿里云镜像、确保Maven用的JDK版本和你项目要求的一致。这三个环节任意一个出错，mvn clean compile就会停在Downloading或Failed to execute goal。

下载并解压Maven

打开浏览器访问 https://www.php.cn/link/5131f6caead4314643b671b624714d94，在Binary zip archive区域点击最新稳定版（如apache-maven-3.9.7-bin.zip）下载。不要选Source zip，那是源码包，不能直接用。

下载完成后，右键→“全部解压缩”，目标文件夹路径【不能含中文、空格或特殊符号】，推荐放在D:\JAVA\Maven\apache-maven-3.9.7。

解压后检查bin目录下是否有mvn.cmd文件——这是Windows启动脚本，没有就说明解压失败或下载不完整。

配置MAVEN_HOME与Path环境变量

按Win+R输入sysdm.cpl→高级→环境变量→系统变量→新建：

变量名填MAVEN_HOME，变量值填你刚才解压的完整路径，例如D:\JAVA\Maven\apache-maven-3.9.7。

在系统变量Path中点击编辑→新建→输入%MAVEN_HOME%\bin。

打开新cmd窗口，执行mvn -v。如果看到Apache Maven 3.9.7和Java version信息，说明环境变量生效；如果提示“不是内部或外部命令”，请关闭所有cmd重开，或检查Path里是否多打了空格、斜杠方向错误。

配置本地仓库路径

在D盘新建文件夹，命名为m2_repository，完整路径如D:\m2_repository。

进入Maven解压目录→conf→settings.xml，用记事本或VS Code打开（不要用Word）。

搜索标签，将其内容替换为你的仓库路径：【D:\m2_repository】。注意不要删掉标签本身，只改中间路径。

Java Maven Code Review

审查Java Maven项目（ZIP压缩包或GitLab仓库URL），检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载

这一步不做也行，但默认仓库在C:\Users\用户名\.m2，容易占满系统盘，且权限受限时写入失败。

配置阿里云镜像源

仍在settings.xml中，找到标签（通常在第150行左右），在和之间插入以下代码：

<mirror>
  <id>aliyun-maven</id>
  <mirrorOf>central</mirrorOf>
  <url>https://maven.aliyun.com/repository/public</url>
</mirror>

【必须插在标签内部，不能放在或里】。插错位置会导致镜像完全不生效，mvn命令仍连国外服务器。

保存settings.xml。之后首次执行mvn dependency:resolve会自动从阿里云拉取索引，速度比默认源快5～10倍。

绑定JDK版本（关键防错步骤）

第一步：确认已安装对应JDK，比如项目要求JDK 17，则需先装好jdk-17.0.x并配置JAVA_HOME。

第二步：在settings.xml中找到标签，在其内部添加如下配置：

<profile>
  <id>jdk-17</id>
  <activation>
    <jdk>17</jdk>
  </activation>
  <properties>
    <maven.compiler.source>17</maven.compiler.source>
    <maven.compiler.target>17</maven.compiler.target>
  </properties>
</profile>

第三步：在同一个块里再加一行激活指令：【jdk-17】，放在之前。

这样Maven启动时会自动匹配JDK 17，避免出现“Unsupported class file major version 61”这类编译错误。