關于Maven中pom.xml文件配置詳解

更新時間：2025年01月21日 16:02:56 作者：AllenBright

pom.xml是Maven項目的核心配置文件,它描述了項目的結構、依賴關系、構建配置等信息,通過合理配置pom.xml,可以提高項目的可維護性和構建效率

1. POM文件的基本結構

一個典型的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.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.allen</groupId>
    <artifactId>my-app</artifactId>
    <version>1.0.0</version>
    <packaging>jar</packaging>

    <properties>
        <!-- 項目屬性 -->
    </properties>

    <dependencies>
        <!-- 項目依賴 -->
    </dependencies>

    <build>
        <!-- 構建配置 -->
    </build>

    <profiles>
        <!-- 構建配置 -->
    </profiles>
</project>

1.1 項目基本信息

modelVersion：指定POM模型的版本，通常為4.0.0。
groupId：項目的組ID，通常為公司或組織的域名反寫。
artifactId：項目的唯一標識符，通常為項目的名稱。
version：項目的版本號。
packaging：項目的打包方式，如jar、war、pom等。

示例：

<project>
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.allen</groupId>
    <artifactId>my-app</artifactId>
    <version>1.0.0</version>
    <packaging>jar</packaging>
</project>

2. 項目屬性

properties部分用于定義項目中使用的屬性，這些屬性可以在pom.xml的其他部分引用。

示例：

<properties>
    <java.version>1.8</java.version>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

2.1 引用屬性

在pom.xml的其他部分，可以通過${property.name}的方式引用屬性。

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>${java.version}</source>
                <target>${java.version}</target>
            </configuration>
        </plugin>
    </plugins>
</build>

3. 項目依賴

dependencies部分用于聲明項目所需的依賴庫。每個依賴項包括groupId、artifactId、version等信息。

示例：

<dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>5.3.9</version>
    </dependency>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.13.2</version>
        <scope>test</scope>
    </dependency>
</dependencies>

依賴范圍（scope）：

compile：默認范圍，依賴在編譯、測試和運行時都可用。
test：僅在測試編譯和執(zhí)行階段可用。
runtime：在運行時可用，但在編譯時不可用。
provided：在編譯和測試時可用，但在運行時由容器提供。
system：類似于provided，但需要顯式指定依賴的路徑。

4. 構建配置

build部分用于配置項目的構建過程，包括插件、資源、源碼目錄等。

示例：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>${java.version}</source>
                <target>${java.version}</target>
            </configuration>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>2.22.2</version>
            <configuration>
                <skipTests>false</skipTests>
            </configuration>
        </plugin>
    </plugins>
</build>

常用插件：

maven-compiler-plugin：配置Java編譯器。
maven-surefire-plugin：配置測試執(zhí)行。
maven-jar-plugin：配置JAR文件的生成。
maven-war-plugin：配置WAR文件的生成。

5. 構建配置文件（Profiles）

profiles部分用于定義不同的構建配置文件，以便在不同的環(huán)境中使用不同的配置。

示例：

<profiles>
    <profile>
        <id>dev</id>
        <properties>
            <env>dev</env>
        </properties>
        <build>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-surefire-plugin</artifactId>
                    <version>2.22.2</version>
                    <configuration>
                        <skipTests>true</skipTests>
                    </configuration>
                </plugin>
            </plugins>
        </build>
    </profile>
    <profile>
        <id>prod</id>
        <properties>
            <env>prod</env>
        </properties>
        <build>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-surefire-plugin</artifactId>
                    <version>2.22.2</version>
                    <configuration>
                        <skipTests>false</skipTests>
                    </configuration>
                </plugin>
            </plugins>
        </build>
    </profile>
</profiles>