Maven 是 Apache 基金會旗下的專案物件模型 (POM) 架構下的專案管理與建構自動化工具。核心功能三大支柱:
官網下載 apache-maven-3.x.x-bin.zip,解壓至任意目錄 (如 D:\dev\maven)。

MAVEN_HOME = D:\dev\mavenPATH 追加 %MAVEN_HOME%\bin

mvn -version
# Apache Maven 3.x.x ... Java version: 1.8.x

| 範圍 | 路徑 | 優先級 |
|---|---|---|
| 全域 | %MAVEN_HOME%/conf/settings.xml | 低 |
| 用戶 | ~/.m2/settings.xml (Windows: %USERPROFILE%\.m2\settings.xml) | 高 (覆蓋全域) |
關鍵配置項:localRepository (本地倉庫路徑)、mirrors (鏡像站、推薦阿里雲)、proxies (代理)、servers (私服認證)、profiles (環境隔離)。


project-root/
├── pom.xml # 專案核心描述檔
├── src/
│ ├── main/
│ │ ├── java/ # 主程式碼
│ │ └── resources/ # 主資源檔 (配置、屬性檔等)
│ └── test/
│ ├── java/ # 測試程式碼
│ └── resources/ # 測試資源
└── target/ # 建構輸出目錄 (自動生成)
├── classes/
├── test-classes/
└── *.jar / *.war

<groupId>com.example</groupId> # 組織/公司倒置域名
<artifactId>my-app</artifactId> # 專案/模組名稱
<version>1.0.0</version> # 版本號 (SNAPSHOT/RELEASE)
<packaging>jar</packaging> # 打包類型: jar, war, pom, ear...

maven-archetype-webapp (Web 專案骨架)。src/main/java, src/test/java, src/test/resources。Java 1.7+, Dynamic Web Module 3.1。target/classes。







<dependencies>
<!-- JUnit 4.11 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.11</version>
<scope>test</scope>
</dependency>
<!-- Servlet API (provided: 容器提供,不打包進 WAR) -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.1.0</version>
<scope>provided</scope>
</dependency>
</dependencies>


| Scope | 編譯 | 測試 | 運行/打包 | 典型用例 |
|---|---|---|---|---|
| compile (預設) | ✓ | ✓ | ✓ | 核心業務依賴 |
| provided | ✓ | ✓ | ✗ | Servlet API, JSP API (容器提供) |
| runtime | ✗ | ✓ | ✓ | JDBC 驅動, 日誌實現 |
| test | ✗ | ✓ | ✗ | JUnit, Mockito |
| system | ✓ | ✓ | ✗ | 本地 jar (不推薦) |
| import | - | - | - | BOM 依賴管理 (dependencyManagement) |
# 清理輸出目錄
mvn clean
# 編譯主程式碼
mvn compile
# 執行單元測試
mvn test
# 打包 (jar/war) - 包含 compile + test
mvn package
# 安裝到本地倉庫 (供其他本地專案依賴)
mvn install
# 部署到遠端私服
mvn deploy
# 跳過測試打包/安裝
mvn package -DskipTests
mvn install -DskipTests
# 依賴樹分析
mvn dependency:tree
mvn dependency:analyze


<modules> 聚合,dependencyManagement 統一版本。mvn release:prepare release:perform 自動化版本號遞增、打 Tag、部署。mvn clean install -U。Maven 以「約定優於配置」統一了 Java 生態的建構語言。掌握 GAV 坐標、依賴範圍、生命週期、POM 繼承/聚合、私服整合,即可駕馭從小專案到企業級多模組系統的全生命週期管理。