Maven Windows 安裝與環境配置圖文教程（含 JDK 版本對應表）

Maven Windows 安裝與環境配置圖文教程（含 JDK 版本對應表）

本文提供 Maven 在 Windows 7+ 系統上的標準化安裝流程，涵蓋 JDK 前置檢查、二進制包下載、環境變量配置、驗證測試全過程，並附帶常見坑點避雷指南。

一、前置條件：JDK 版本對應表

⚠️ 務必先配置好 JAVA_HOME 並加入 PATH，Maven 啟動腳本依賴它定位 java 命令。

二、下載與解壓

1. 官網：https://maven.apache.org/download.html；
2. 下載 Binary zip（如 apache-maven-3.9.6-bin.zip）；
3. 解壓到無中文、無空格路徑，例：D:\apache-maven-3.9.6。

三、環境變量配置（系統變量）

四、驗證安裝

C:\> mvn -version
Apache Maven 3.9.6 (xxxx)
Maven home: D:\apache-maven-3.9.6
Java version: 17.0.9, vendor: Oracle Corporation
Default locale: zh_CN, platform encoding: UTF-8
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"

✅ 出現版本信息即安裝成功。若報 JAVA_HOME not found，請回檢 JDK 配置。

五、常見坑點與解決

1. 中文路徑/空格路徑：導致類加載失敗，請移至純英文路徑；
2. 多版本共存：通过修改 PATH 順序切換，或在項目中使用 mvnw (Maven Wrapper) 鎖定版本；
3. 代理/鏡像配置：國內環境請修改 settings.xml 配置阿里云鏡像，大幅提升下載速度（見下篇倉庫配置）。

下一篇將詳細講解 Maven 倉庫機制、本地倉庫遷移與鏡像配置。