Windows 上安装配置 Maven 3.9.x

在 Windows 上安装配置 Maven，核心是先确保 JDK 环境正常，再下载解压、配置环境变量、验证，最后优化本地仓库与国内镜像。

一、前置条件：安装并配置 JDK

Maven 依赖 Java 运行，必须先配置好 JDK 环境：

1. 安装 JDK（推荐 JDK 8/11/17）
2. 配置系统环境变量：
   • 新建 JAVA_HOME，值为 JDK 根目录（如 C:\Program Files\Java\jdk1.8.0_401）
   • 在 Path 中添加 %JAVA_HOME%\bin
3. 验证：打开新 CMD，执行

   java -version
   javac -version
   

   输出版本信息即正常。

二、下载 Maven

1. 访问 Apache Maven 官网
2. 下载 Binary zip archive（如 apache-maven-3.9.9-bin.zip）
3. 校验文件完整性（可选）：下载对应 sha512 文件，验证压缩包未损坏

三、解压与目录规范

1. 解压 zip 到无中文、无空格的目录（关键）
   • 推荐：C:\apache-maven-3.9.9 或 D:\Maven\apache-maven-3.9.9
   • 避免：C:\Program Files\...（含空格易出问题）
2. 目录结构（确认存在）：

   apache-maven-3.9.9
   ├── bin
   ├── boot
   ├── conf
   ├── lib
   └── ...
   

四、配置环境变量（系统级别）

方法 1：图形界面（推荐）

1. 打开环境变量：
   • Win+R → 输入 sysdm.cpl → 高级 → 环境变量
   • 或：此电脑 → 右键属性 → 高级系统设置 → 环境变量
2. 新建系统变量：
   • 变量名：MAVEN_HOME
   • 变量值：Maven 解压根目录（如 C:\apache-maven-3.9.9）
3. 编辑 Path（系统变量）：
   • 新建 → 输入 %MAVEN_HOME%\bin → 确定保存

方法 2：命令行（快速）

以管理员身份打开 CMD，执行：

setx MAVEN_HOME "C:\apache-maven-3.9.9" /M
setx Path "%Path%;%MAVEN_HOME%\bin" /M

提示：配置后必须重启 CMD/终端才生效。

五、验证安装

打开新的 CMD，执行：

mvn -v
# 或
mvn -version

成功输出示例：

Apache Maven 3.9.9 (ce9ed80a605b4a3b7c3f2dc8406a4a375240296e)
Maven home: C:\apache-maven-3.9.9
Java version: 1.8.0_401, vendor: Oracle Corporation
Java home: C:\Program Files\Java\jdk1.8.0_401\jre
Default locale: zh_CN, platform encoding: GBK
OS name: "windows 11", version: "10.0", arch: "amd64", family: "windows"

若提示“不是内部命令”：检查 Path 是否正确、是否重启 CMD、路径是否含中文/空格。

六、核心配置（settings.xml）

编辑 conf/settings.xml，优化本地仓库与国内镜像（提升下载速度）。

1. 自定义本地仓库（默认在 ~/.m2/repository）

找到 <localRepository> 节点，取消注释并修改路径：

<localRepository>D:\Maven\repository</localRepository>

路径同样不能有中文/空格。

2. 配置阿里云镜像（加速依赖下载）

找到 <mirrors> 节点，添加阿里云镜像：

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

3. 配置 JDK 版本（可选）

找到 <profiles> 节点，添加：

<profile>
  <id>jdk-1.8</id>
  <activation>
    <activeByDefault>true</activeByDefault>
  </activation>
  <properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
  </properties>
</profile>

七、测试 Maven 项目（可选）

1. 新建项目目录，执行：

   mvn archetype:generate -DgroupId=com.example -DartifactId=demo -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
   

2. 进入项目，编译打包：

   cd demo
   mvn clean package
   

   成功后在 target 目录生成 jar 包。

八、常见问题

1. mvn -v 报错“不是内部命令”
   • 重启 CMD
   • 检查 MAVEN_HOME 路径是否正确、Path 是否包含 %MAVEN_HOME%\bin
   • 路径是否含中文/空格
2. 下载依赖极慢
   • 配置阿里云镜像
   • 检查网络/代理
3. JDK 版本不兼容
   • 确保 JAVA_HOME 指向 JDK（非 JRE）
   • 升级 JDK 到 8+