Maven 安裝與配置入門筆記（Windows 環境）

Maven 安裝與配置入門筆記（Windows 環境）

記錄首次學習 Maven 時的安裝配置步驟，適用於 Windows + JDK 1.8+ 環境。

1. 下載 Maven

官網：https://maven.apache.org/
下載 Binary zip 壓縮包（如 apache-maven-3.9.x-bin.zip）。

2. 解壓至任意目錄

建議路徑無中文、無空格，例如：D:\maven\apache-maven-3.9.6

3. 配置環境變數（系統變數）

前提：已配置 JAVA_HOME 並加入 %JAVA_HOME%\bin 到 Path。Maven 3.3+ 需 JDK 1.7+，建議 JDK 1.8 或 11/17 LTS。

4. 驗證安裝

打開新命令提示字元（需重新開啟生效環境變數），執行：

mvn -version

預期輸出：

Apache Maven 3.9.6 (xxxx)
Maven home: D:\maven\apache-maven-3.9.6
Java version: 1.8.0_xxx, vendor: Oracle Corporation
Java home: C:\Program Files\Java\jdk1.8.0_xxx\jre
Default locale: zh_TW, platform encoding: UTF-8
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"

5. 進階配置（可選但推薦）

修改本地倉庫位置

編輯 %MAVEN_HOME%\conf\settings.xml，在 <settings> 下添加：

<localRepository>D:/maven/repository</localRepository>

避免 C 盤空間不足。

配置阿里雲鏡像加速

在 <mirrors> 區塊添加：

<mirror>
  <id>aliyun</id>
  <name>Aliyun Maven Mirror</name>
  <url>https://maven.aliyun.com/repository/public</url>
  <mirrorOf>central</mirrorOf>
</mirror>

設定 JDK 編碼與版本

在 <profiles> 添加啟用配置：

<profile>
  <id>jdk-1.8</id>
  <activation>
    <activeByDefault>true</activeByDefault>
    <jdk>1.8</jdk>
  </activation>
  <properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>
</profile>

6. 常見問題

• mvn 不是內部命令 → Path 未生效，重開 CMD 或檢查路徑拼寫。
• 下載依賴超時 → 檢查網路、鏡像配置、防火牆/代理設定。
• 編碼警告 → 確保 project.build.sourceEncoding 設為 UTF-8。