Maven 3.3.9 安裝與環境配置完整指南（Windows/Linux）

Maven 3.3.9 安裝與環境配置完整指南

Apache Maven 是 Java 專案管理與建構自動化的核心工具。本文詳細記錄 Maven 3.3.9 在 Windows 與 Linux 環境下的安裝、環境變數設定、本地/遠端倉庫配置，並驗證安裝成果，助你快速建立標準化的建構環境。

一、Windows 環境安裝步驟

1. 下載安裝包

前往官網 https://maven.apache.org/download.cgi，下載 apache-maven-3.3.9-bin.zip 或 .tar.gz 版本均可。

2. 解壓並放置目錄

將壓縮檔解壓至任意目錄，建議路徑：C:\Program Files\maven\apache-maven-3.3.9。

3. 設定環境變數

• MAVEN_HOME：C:\Program Files\maven\apache-maven-3.3.9
• MAVEN_OPTS：-Xms128m -Xmx512m（視記憶體需求可選配置）
• Path 追加：%MAVEN_HOME%\bin;

4. 驗證安裝

開啟 CMD 輸入 mvn -v，若顯示版本資訊、Java 版本與 Maven home 路徑，即代表安裝成功。

5. 核心概念：本地倉庫與遠端倉庫

Maven 最大優勢在於統一管理 JAR 套件。預設本地倉庫位於 ${MAVEN_HOME}/conf/settings.xml 的 <localRepository> 標籤指定路徑，可視為「快取」。專案優先從本地倉庫取得依賴；若無則從遠端倉庫（中央倉庫）下載並快取到本地，隨專案累積本地倉庫會持續增長。

6. 修改 settings.xml 自訂倉庫與鏡像

<!-- 自訂本地倉庫路徑 -->
<localRepository>E:\fengzi\MavenRepository</localRepository>

<!-- 使用阿里雲 Maven 鏡像加速下載 -->
<mirror>
  <id>alimaven</id>
  <name>aliyun maven</name>
  <url>https://maven.aliyun.com/nexus/content/groups/public/</url>
  <mirrorOf>central</mirrorOf>
</mirror>

設定完成後執行 mvn help:system 驗證，觀察本地倉庫是否開始下載檔案。

二、Linux 環境安裝步驟

1. 下載與解壓

wget https://mirrors.hust.edu.cn/apache/maven/maven-3/3.3.9/binaries/apache-maven-3.3.9-bin.tar.gz
tar zxvf apache-maven-3.3.9-bin.tar.gz -C /usr/local/maven/

2. 配置環境變數

編輯 /etc/profile（需 root 權限），於檔案末尾新增：

# Maven Environment
export MAVEN_HOME=/usr/local/maven/apache-maven-3.3.9
export MAVEN_OPTS="-Xms256m -Xmx512m"
export PATH=$MAVEN_HOME/bin:$PATH

執行 source /etc/profile 使配置生效。

3. 驗證

mvn -version
# 輸出範例：
# Apache Maven 3.3.9 ...
# Maven home: /usr/local/maven/apache-maven-3.3.9
# Java version: 1.8.0_XXX ...

4. Linux 同樣需修改 settings.xml 設定本地倉庫與阿里雲鏡像，操作與 Windows 一致。

三、常見問題與建議

• 權限問題：Linux 下若遇權限不足，請確保 Maven 目錄擁有者為執行使用者，或使用 sudo 執行。
• JDK 版本：Maven 3.3.9 需 JDK 1.7+，建議搭配 JDK 8 獲得最佳相容性。
• 離線模式：無網路環境可使用 mvn -o 參數啟用離線模式，僅使用本地倉庫。

參考資源：Maven 詳細配置說明