快捷導(dǎo)航

Windows下安裝Maven的詳細(xì)教程(含鏡像與本地倉(cāng)庫(kù)配置)

更新時(shí)間：2026年04月14日 08:33:34 作者：李少兄

Maven?是?Java?生態(tài)系統(tǒng)中不可或缺的項(xiàng)目管理和構(gòu)建自動(dòng)化工具,本文詳細(xì)介紹了在Windows系統(tǒng)上安裝和配置Maven的完整流程,希望對(duì)大家有所幫助

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

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

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

1. 驗(yàn)證 JDK 是否已安裝

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

java -version

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

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

2. JDK 版本與 Maven 的兼容性

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

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

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

即使 java -version 命令有效，也強(qiáng)烈建議顯式設(shè)置 JAVA_HOME 環(huán)境變量，因?yàn)樵S多構(gòu)建工具（包括 Maven）會(huì)優(yōu)先讀取此變量來(lái)定位 JDK。

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

二、下載與安裝 Maven

1. 獲取 Maven 安裝包

訪問(wèn) Maven 官方下載頁(yè)面：https://maven.apache.org/download.cgi

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

2. 解壓安裝包

Maven 是一個(gè)“綠色軟件”，無(wú)需復(fù)雜的安裝過(guò)程，解壓即用。

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

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

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

1.設(shè)置 MAVEN_HOME:

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

2.更新 Path 變量:

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

3. 驗(yàn)證 Maven 安裝

重新打開(kāi)一個(gè)新的命令提示符窗口（重要：必須是新窗口，以加載新的環(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 版本及運(yùn)行時(shí)路徑，證明安裝和環(huán)境變量配置均已完成。

四、配置本地倉(cāng)庫(kù)（Local Repository）

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

1. 創(chuàng)建本地倉(cāng)庫(kù)目錄

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

2. 修改settings.xml文件

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

使用文本編輯器（如 VS Code、Notepad++）打開(kāi) settings.xml。
在文件中找到 <settings> 根標(biāo)簽。
在 <settings> 標(biāo)簽內(nèi)，找到被注釋掉的 <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 路徑中，可以使用正斜杠 / 或雙反斜杠 \\。使用正斜杠是更通用且不易出錯(cuò)的做法。

3. 驗(yàn)證本地倉(cāng)庫(kù)配置

執(zhí)行一次簡(jiǎn)單的 Maven 命令（如 mvn archetype:generate 并中斷），然后檢查你指定的 D:\maven-repo 目錄是否開(kāi)始有文件寫入。或者，在后續(xù)的項(xiàng)目構(gòu)建中，所有下載的依賴都將出現(xiàn)在此目錄下。

五、配置國(guó)內(nèi)鏡像（Mirror）以加速依賴下載

Maven 默認(rèn)從位于美國(guó)的中央倉(cāng)庫(kù)（repo.maven.apache.org）下載依賴，這在國(guó)內(nèi)會(huì)導(dǎo)致速度極慢甚至超時(shí)。配置國(guó)內(nèi)鏡像源是提升開(kāi)發(fā)效率的關(guān)鍵一步。

1. 選擇鏡像源

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

2. 在settings.xml中配置鏡像

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

找到 <mirrors> 標(biāo)簽塊（通常在文件中部）。
在 <mirrors> 標(biāo)簽內(nèi)，添加以下阿里云鏡像配置：

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

關(guān)鍵參數(shù)解釋：

<id>: 鏡像的唯一標(biāo)識(shí)符，可自定義。
<mirrorOf>: 最重要的字段。central 表示此鏡像將替代 Maven 中央倉(cāng)庫(kù)。* 表示替代所有倉(cāng)庫(kù)（不推薦，可能會(huì)導(dǎo)致私有倉(cāng)庫(kù)無(wú)法訪問(wèn)）。spring-milestones,spring-snapshots 表示替代特定的倉(cāng)庫(kù) ID。
<url>: 鏡像的實(shí)際地址。

通過(guò)以上配置，所有原本指向中央倉(cāng)庫(kù)的請(qǐng)求都將被重定向到阿里云，從而獲得飛一般的下載速度。

額外提示：

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

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

您可能感興趣的文章: