萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Maven 入門到實戰:專案管理、依賴解析與生命週期完全指南

什麼是 Maven?

Maven 是 Apache 基金會旗下的專案物件模型 (POM) 架構下的專案管理與建構自動化工具。核心功能三大支柱:

  1. 專案建構標準化: 統一目錄結構、建構流程、輸出產物。
  2. 依賴管理: 宣告式依賴、傳遞性依賴解析、版本衝突調解、中央/私有倉庫。
  3. 專案資訊管理: 文件生成、報表、站點發佈、版本發布。

安裝與環境配置

1. 下載解壓

官網下載 apache-maven-3.x.x-bin.zip,解壓至任意目錄 (如 D:\dev\maven)。

Maven 解壓目錄

2. 環境變數 (需先配置 JAVA_HOME)

  • MAVEN_HOME = D:\dev\maven
  • PATH 追加 %MAVEN_HOME%\bin
MAVEN_HOME 設定
PATH 設定

3. 驗證安裝

mvn -version
# Apache Maven 3.x.x ... Java version: 1.8.x
驗證成功

4. 核心配置:settings.xml

範圍路徑優先級
全域%MAVEN_HOME%/conf/settings.xml低
用戶~/.m2/settings.xml (Windows: %USERPROFILE%\.m2\settings.xml)高 (覆蓋全域)

關鍵配置項:localRepository (本地倉庫路徑)、mirrors (鏡像站、推薦阿里雲)、proxies (代理)、servers (私服認證)、profiles (環境隔離)。

全域 settings.xml
用戶 settings.xml

標準專案目錄結構 (約定優於配置)

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

Maven 坐標 (GAV) - 依賴的唯一身分證

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

IDE 整合:MyEclipse / Eclipse (m2eclipse) / IntelliJ IDEA

  1. 新建 Maven Project → 選擇 maven-archetype-webapp (Web 專案骨架)。
  2. 填寫 GAV 坐標。
  3. 修正預設缺失目錄: 專案屬性 → Java Build Path → Source → 新增 src/main/java, src/test/java, src/test/resources。
  4. 設定 JRE/JDK: Libraries → JRE System Library → 編輯 → 選擇已安裝 JDK (非 JRE)。
  5. Project Facets: 勾選 Java 1.7+, Dynamic Web Module 3.1。
  6. 輸出目錄: 設為 target/classes。
  7. 部署組裝: 移除測試相關目錄,只部署主程式與資源。
新建 Maven Project
選擇 Workspace
選擇 Archetype
修正 Source 目錄
設定 JDK
Project Facets
輸出目錄
部署組裝

POM.xml 依賴管理實戰

<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>
POM 依賴編輯
依賴解析成功

依賴範圍 (Scope) 核心差異

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
Run As Maven Install
target 輸出產物

進階實戰技巧

  • 多模組專案: 父 POM <modules> 聚合,dependencyManagement 統一版本。
  • Profile 環境隔離: dev/test/prod 不同配置、資料庫、啟用模組。
  • 私服搭建: Nexus / Artifactory / Harbor 加速構建、管控發布。
  • 版本發布流程: mvn release:prepare release:perform 自動化版本號遞增、打 Tag、部署。
  • 強制更新快照: mvn clean install -U。

總結

Maven 以「約定優於配置」統一了 Java 生態的建構語言。掌握 GAV 坐標、依賴範圍、生命週期、POM 繼承/聚合、私服整合,即可駕馭從小專案到企業級多模組系統的全生命週期管理。

copyright © 萬盛學電腦網 all rights reserved