Maven 是 Java 生態(tài)系統中不可或缺的項目管理和構建自動化工具。它通過項目對象模型（POM）的概念，標準化了項目的構建、依賴管理、文檔生成等流程。對于 Windows 開發(fā)者而言，正確安裝和配置 Maven 是高效進行 Java 項目開發(fā)的第一步。

一、安裝前的核心準備：確認并配置 JDK 環(huán)境

Maven 本身是用 Java 編寫的，因此其運行完全依賴于 Java Development Kit (JDK)。在安裝 Maven 之前，必須確保系統中已正確安裝并配置了 JDK。

1. 驗證 JDK 是否已安裝

按下 Win + R 鍵，輸入 cmd 打開命令提示符，執(zhí)行以下命令：

java -version

如果命令成功返回 JDK 的版本信息（例如 java ve

rsion "17.0.12" 2025-04-15 LTS），則說明 JDK 已安裝。如果提示 'java' 不是內部或外部命令，則需要先安裝 JDK。

2. JDK 版本與 Maven 的兼容性

選擇合適的 JDK 版本至關重要，以確保與所選 Maven 版本的兼容性。

• Maven 3.9.x（當前主流穩(wěn)定版）：要求運行環(huán)境為 JDK 8 或更高版本。
• Maven 3.8.x：同樣支持 JDK 8 及以上。
• 最佳實踐：建議使用 JDK 17（LTS 長期支持版本）或 JDK 21（最新 LTS 版本）作為開發(fā)環(huán)境，它們能完美兼容所有現代 Maven 版本，并提供最新的語言特性和性能優(yōu)化。

3. 配置 JAVA_HOME 環(huán)境變量

即使 java -version 命令有效，也強烈建議顯式設置 JAVA_HOME 環(huán)境變量，因為許多構建工具（包括 Maven）會優(yōu)先讀取此變量來定位 JDK。

1. 在文件資源管理器中，找到你的 JDK 安裝目錄（例如 C:\Program Files\Java\jdk-17.0.12）。
2. 按下 Win + S，搜索“環(huán)境變量”，并選擇“編輯系統環(huán)境變量”。
3. 在“系統屬性”窗口中，點擊“環(huán)境變量”按鈕。
4. 在“系統變量”區(qū)域，點擊“新建”。
   • 變量名: JAVA_HOME
   • 變量值: 你的 JDK 安裝目錄的完整路徑（不包含 bin 文件夾）。
5. 點擊“確定”保存。此時，Maven 將能夠準確無誤地找到 JDK。

二、下載與安裝 Maven

1. 獲取 Maven 安裝包

訪問 Maven 官方下載頁面：https://maven.apache.org/download.cgi

• 推薦下載：選擇 Binary zip archive (apache-maven-{version}-bin.zip)。這是適用于 Windows 系統的標準分發(fā)包。
• 歷史版本：如需特定舊版本，可前往存檔頁面：https://archive.apache.org/dist/maven/maven-3/。

2. 解壓安裝包

Maven 是一個“綠色軟件”，無需復雜的安裝過程，解壓即用。

1. 選擇一個不含中文、空格或特殊字符的目錄作為 Maven 的安裝根目錄。例如：D:\dev-tools\apache-maven-3.9.9。
2. 將下載的 .zip 文件解壓到該目錄。解壓后，目錄結構應包含以下關鍵文件夾：
   • bin/: 存放可執(zhí)行腳本，如 mvn.cmd。
   • conf/: 存放核心配置文件 settings.xml。
   • lib/: 存放 Maven 運行所需的 JAR 庫文件。

三、配置 Maven 環(huán)境變量

為了讓系統在任何位置都能識別 mvn 命令，需要將其添加到系統的 PATH 環(huán)境變量中。

1.設置 MAVEN_HOME:

• 再次打開“環(huán)境變量”設置窗口。
• 在“系統變量”中，點擊“新建”。
  • 變量名: MAVEN_HOME
  • 變量值: Maven 的安裝根目錄（例如 D:\dev-tools\apache-maven-3.9.9）。

2.更新 Path 變量:

• 在“系統變量”列表中，找到名為 Path 的變量，并雙擊或選中后點擊“編輯”。
• 點擊“新建”，然后輸入 %MAVEN_HOME%\bin。
• 點擊“確定”保存所有更改。

3. 驗證 Maven 安裝

重新打開一個新的命令提示符窗口（重要：必須是新窗口，以加載新的環(huán)境變量），執(zhí)行以下命令：

mvn -v

如果配置成功，你將看到類似如下的輸出：

Apache Maven 3.9.9 (8e8579a7e0d6f1c1b3b5b5b5b5b5b5b5b5b5b5b5)
Maven home: D:\dev-tools\apache-maven-3.9.9
Java version: 17.0.12, vendor: Oracle Corporation, runtime: C:\Program Files\Java\jdk-17.0.12
Default locale: zh_CN, platform encoding: GBK
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"

此輸出清晰地展示了 Maven 版本、安裝路徑、所使用的 Java 版本及運行時路徑，證明安裝和環(huán)境變量配置均已完成。

四、配置本地倉庫（Local Repository）

Maven 會將項目依賴（JAR 包等）下載并緩存在本地倉庫中，以避免重復下載。默認情況下，本地倉庫位于用戶主目錄下的 .m2/repository 文件夾（例如 C:\Users\YourName\.m2\repository）。為了更好的磁盤空間管理和項目隔離，建議自定義本地倉庫路徑。

1. 創(chuàng)建本地倉庫目錄

在你希望的位置創(chuàng)建一個新的文件夾，例如 D:\maven-repo。

2. 修改settings.xml文件

settings.xml 是 Maven 的全局配置文件，位于 Maven 安裝目錄的 conf 文件夾下（%MAVEN_HOME%\conf\settings.xml）。

1. 使用文本編輯器（如 VS Code、Notepad++）打開 settings.xml。
2. 在文件中找到 <settings> 根標簽。
3. 在 <settings> 標簽內，找到被注釋掉的 <localRepository> 行（通常在第 55 行左右）。取消注釋，并將其值修改為你剛剛創(chuàng)建的目錄路徑。

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                              https://maven.apache.org/xsd/settings-1.0.0.xsd">
  <!-- localRepository
   | The path to the local repository maven will use to store artifacts.
   |
   | Default: ${user.home}/.m2/repository
  -->
  <localRepository>D:/maven-repo</localRepository>
  <!-- 其他配置... -->
</settings>

注意：在 Windows 路徑中，可以使用正斜杠 / 或雙反斜杠 \\。使用正斜杠是更通用且不易出錯的做法。

3. 驗證本地倉庫配置

執(zhí)行一次簡單的 Maven 命令（如 mvn archetype:generate 并中斷），然后檢查你指定的 D:\maven-repo 目錄是否開始有文件寫入?；蛘?，在后續(xù)的項目構建中，所有下載的依賴都將出現在此目錄下。

五、配置國內鏡像（Mirror）以加速依賴下載

Maven 默認從位于美國的中央倉庫（repo.maven.apache.org）下載依賴，這在國內會導致速度極慢甚至超時。配置國內鏡像源是提升開發(fā)效率的關鍵一步。

1. 選擇鏡像源

國內最常用、最穩(wěn)定的鏡像是 阿里云 Maven 鏡像。

2. 在settings.xml中配置鏡像

繼續(xù)編輯 conf/settings.xml 文件。

1. 找到 <mirrors> 標簽塊（通常在文件中部）。
2. 在 <mirrors> 標簽內，添加以下阿里云鏡像配置：

<settings>
  <!-- ... 其他配置，包括 localRepository ... -->
  <mirrors>
    <!-- 阿里云公共倉庫鏡像 -->
    <mirror>
      <id>aliyunmaven</id>
      <mirrorOf>central</mirrorOf>
      <name>阿里云公共倉庫</name>
      <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
    <!-- 阿里云 Spring 插件倉庫鏡像（可選，但推薦） -->
    <mirror>
      <id>aliyun-spring</id>
      <mirrorOf>spring-milestones,spring-snapshots</mirrorOf>
      <name>阿里云 Spring 插件倉庫</name>
      <url>https://maven.aliyun.com/repository/spring</url>
    </mirror>
  </mirrors>
  <!-- ... 其他配置 ... -->
</settings>

關鍵參數解釋：

• <id>: 鏡像的唯一標識符，可自定義。
• <mirrorOf>: 最重要的字段。central 表示此鏡像將替代 Maven 中央倉庫。* 表示替代所有倉庫（不推薦，可能會導致私有倉庫無法訪問）。spring-milestones,spring-snapshots 表示替代特定的倉庫 ID。
• <url>: 鏡像的實際地址。

通過以上配置，所有原本指向中央倉庫的請求都將被重定向到阿里云，從而獲得飛一般的下載速度。

額外提示：

• IDE 集成：在 IntelliJ IDEA 或 Eclipse 中，記得在 Maven 設置里指定你自定義的 settings.xml 文件和本地倉庫路徑，以確保 IDE 內的構建行為與命令行一致。
• 配置文件優(yōu)先級：Maven 會同時讀取全局配置（%MAVEN_HOME%\conf\settings.xml）和用戶配置（%USER_HOME%\.m2\settings.xml）。后者優(yōu)先級更高，適合存放個人敏感信息。

到此這篇關于Windows下安裝Maven的詳細教程(含鏡像與本地倉庫配置)的文章就介紹到這了,更多相關Windows安裝Maven內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

最新評論