Maven 專案管理工具：安裝配置、本地倉庫與專案生成實戰全紀錄

Maven 定位

專案管理與理解工具，超越 Ant 的建構腳本模式，提供專案物件模型 (POM)、依賴管理、標準化建構生命週期、插件生態。學習曲線陡峭但長期收益高。

安裝與環境配置

1. 下載 ZIP 解壓至自訂目錄（如 D:\maven）
2. 設定環境變數：
   • JAVA_HOME → JDK 目錄
   • MAVEN_HOME → Maven 解壓目錄
   • PATH 追加 %MAVEN_HOME%\bin
3. 修改 %MAVEN_HOME%\lib\maven.jar 內 defaults.properties：

   maven.home.local = ${maven.home}/local
   maven.repo.remote = https://repo1.maven.org/maven2, https://repo.maven.apache.org/maven2

4. 執行 %MAVEN_HOME%\bin\install_repo.bat %MAVEN_HOME%local repository 初始化本地倉庫（可略過，首次使用自動下載）
5. 修正中文亂碼：將 maven.jar/org/apache/maven/messages/messages_zh_CN.properties 用 native2ascii 轉碼後覆蓋回原位

生成第一個標準專案

> mkdir test && cd test
> maven genapp
# 選擇模板: default
# 輸入 groupId, artifactId, package 名稱
# 自動產生標準目錄結構

標準目錄結構

test/
├─ pom.xml              ← 專案描述檔
├─ src/
│  ├─ main/
│  │  ├─ java/          ← 主程式碼
│  │  └─ resources/     ← 資源檔
│  └─ test/
│     ├─ java/          ← 測試程式碼
│     └─ resources/     ← 測試資源
└─ target/              ← 建構輸出

核心命令速查

常見問題排查

• 下載依賴失敗：檢查網路、鏡像站配置、防火牆
• 編碼問題：統一專案編碼 UTF-8，pom.xml 設定 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
• 版本衝突：maven dependency:tree 分析傳遞性依賴，使用 <exclusion> 排除