前言

在 Java 開發領域，Apache Maven 是一個強大的項目管理和構建自動化工具。而pom.xml文件，作為 Maven 項目的“心臟”，定義了項目的方方面面。本文將帶你深入了解pom.xml中最常用和最重要的配置項，幫助你快速掌握 Maven 的核心配置。

什么是 POM？

POM（Project Object Model，項目對象模型）是 Maven 的基本工作單元，以 XML 文件（pom.xml）的形式存在。它包含了項目構建、依賴、插件等所有信息。

核心配置項詳解

一個典型的pom.xml文件結構如下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0http://maven.apache.org/xsd/maven-4.0.0.xsd"><!-- 1. 基本坐標信息 --><modelVersion>4.0.0</modelVersion><groupId>com.example</groupId><artifactId>my-project</artifactId><version>1.0.0-SNAPSHOT</version><packaging>jar</packaging><!-- 2. 項目信息 --><name>My Project</name><description>A sample Maven project</description><url>https://example.com/my-project</url><!-- 3. 依賴管理 --><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId><version>2.7.0</version></dependency><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.13.2</version><scope>test</scope></dependency></dependencies><!-- 4. 屬性定義 --><properties><maven.compiler.source>11</maven.compiler.source><maven.compiler.target>11</maven.compiler.target><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding><spring-boot.version>2.7.0</spring-boot.version></properties><!-- 5. 構建配置 --><build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><version>2.7.0</version></plugin><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.8.1</version><configuration><source>11</source><target>11</target></configuration></plugin></plugins></build><!-- 6. 依賴版本管理 (Dependency Management) --><dependencyManagement><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-dependencies</artifactId><version>2.7.0</version><type>pom</type><scope>import</scope></dependency></dependencies></dependencyManagement></project>

1. 基本坐標 (GAV)

這是 POM 最核心的部分，用于唯一標識一個項目或依賴：

• <groupId>: 組織或項目的唯一標識，通常使用反向域名（如 com.example）。
• <artifactId>: 項目本身的名稱（如 my-project）。
• <version>: 項目的版本號（如 1.0.0-SNAPSHOT）。SNAPSHOT表示開發中的快照版本。
• <packaging>: 打包類型，常見值有 jar (默認), war, pom。

2. 依賴管理 (<dependencies>)

這是 Maven 最強大的功能之一，用于聲明項目所依賴的庫。

<dependencies><dependency><groupId>org.springframework</groupId><artifactId>spring-core</artifactId><version>5.3.21</version><scope>compile</scope> <!-- 依賴范圍 --></dependency>
</dependencies>

• 依賴范圍 (Scope): 控制依賴在不同階段的可用性：
  • compile (默認): 在編譯、測試、運行時都可用。
  • test: 僅在測試編譯和執行階段可用（如 JUnit）。
  • provided: 編譯和測試時需要，但運行時由 JDK 或容器提供（如 Servlet API）。
  • runtime: 編譯時不需要，但運行和測試時需要（如 JDBC 驅動）。
  • system: 類似 provided，但需要指定本地系統路徑（不推薦）。

3. 屬性 (<properties>)

用于定義可重用的變量，提高配置的可維護性。

<properties><java.version>11</java.version><spring.version>5.3.21</spring.version><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties><!-- 使用示例 -->
<dependency><groupId>org.springframework</groupId><artifactId>spring-core</artifactId><version>${spring.version}</version>
</dependency>

4. 構建配置 (<build>)

定義項目的構建過程，包括使用的插件。

• <plugins>: 聲明構建過程中使用的 Maven 插件。
  • maven-compiler-plugin: 配置 Java 編譯器（源碼和目標版本）。
  • maven-surefire-plugin: 運行單元測試。
  • maven-jar-plugin / maven-war-plugin: 打包項目。
  • spring-boot-maven-plugin: 為 Spring Boot 應用提供打包和運行支持。

5. 依賴版本管理 (<dependencyManagement>)

這是管理大型項目或模塊化項目依賴版本的利器。

• 在父 POM 或 BOM（Bill of Materials）中使用。
• 聲明依賴的版本，但不直接引入依賴。
• 子模塊在 <dependencies> 中聲明相同 groupId 和 artifactId 的依賴時，可以省略 <version>，自動繼承 <dependencyManagement> 中定義的版本。
• 常用于引入像 spring-boot-dependencies 這樣的 BOM，統一管理 Spring Boot 生態下所有組件的兼容版本。

<dependencyManagement><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-dependencies</artifactId><version>2.7.0</version><type>pom</type><scope>import</scope></dependency></dependencies>
</dependencyManagement>

總結

pom.xml是 Maven 項目的配置中心。掌握其核心配置項：

1. GAV 坐標：唯一標識項目和依賴。
2. <dependencies>：聲明項目所需庫。
3. <properties>：定義可復用的變量。
4. <build>：配置構建過程和插件。
5. <dependencyManagement>：集中管理依賴版本，確保一致性。

通過合理配置這些元素，你可以高效地管理 Java 項目的依賴、構建和發布流程。記住，一個清晰、規范的pom.xml是項目成功的基礎。