Maven项目中的核心配置文件POM.xml详解

pom.xml是Maven项目的核心配置文件，定义了项目的基本信息、依赖关系和构建配置。主要内容包括：项目坐标（groupId、artifactId、version）、基本信息（名称、描述）、依赖管理（依赖声明、范围控制）、构建配置（源码目录、插件设置）、多模块管理、仓库配置以及属性定义。该文件采用XML格式，通过合理配置可实现项目依赖管理、构建过程控制和多模块项目协调，是Maven项目管理的基础

codeer力

1196人浏览 · 2025-05-26 10:50:17

codeer力 · 2025-05-26 10:50:17 发布

Maven项目核心配置文件pom.xml详解

pom.xml(Project Object Model)是Maven项目的核心配置文件，它定义了项目的基本信息、依赖关系、构建配置等。下面我将从基础结构到高级配置全面解析pom.xml文件。

一、基础结构

一个最简单的pom.xml文件包含以下基本元素：

<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 
                             https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    
    <!-- 基本信息 -->
    <groupId>com.example</groupId>
    <artifactId>demo-project</artifactId>
    <version>1.0.0</version>
    <packaging>jar</packaging>
    
    <!-- 更多配置... -->
</project>

二、主要元素详解

1. 项目坐标(必须)

<groupId>: 组织标识，通常使用公司/组织域名反写
<artifactId>: 项目名称
<version>: 项目版本号
<packaging>: 打包类型(jar/war/pom等)，默认为jar

2. 项目基本信息(可选)

<name>Demo Project</name>
<description>A sample Maven project</description>
<url>http://example.com</url>

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

3. 依赖管理

基本依赖配置

<dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>5.3.8</version>
        <scope>compile</scope>
    </dependency>
    
    <!-- 测试依赖 -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.13.2</version>
        <scope>test</scope>
    </dependency>
</dependencies>

依赖范围(scope)

范围(scope)	说明
compile	默认范围，编译、测试、运行都有效
provided	编译和测试有效，运行时由容器提供
runtime	测试和运行有效，编译时不需要
test	仅测试有效
system	系统范围，需要显式提供JAR

依赖管理(Dependency Management)

用于统一管理多模块项目的依赖版本：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-framework-bom</artifactId>
            <version>5.3.8</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

4. 构建配置

<build>
    <!-- 默认源代码目录 -->
    <sourceDirectory>src/main/java</sourceDirectory>
    <testSourceDirectory>src/test/java</testSourceDirectory>
    
    <!-- 插件配置 -->
    <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>
                <encoding>${project.build.sourceEncoding}</encoding>
            </configuration>
        </plugin>
        
        <!-- 打包插件 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>3.2.0</version>
            <configuration>
                <archive>
                    <manifest>
                        <addClasspath>true</addClasspath>
                        <mainClass>com.example.Main</mainClass>
                    </manifest>
                </archive>
            </configuration>
        </plugin>
    </plugins>
    
    <!-- 资源文件处理 -->
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <filtering>true</filtering>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
        </resource>
    </resources>
</build>

5. 多模块配置

<modules>
    <module>module1</module>
    <module>module2</module>
</modules>

<!-- 父POM配置 -->
<parent>
    <groupId>com.example</groupId>
    <artifactId>parent-project</artifactId>
    <version>1.0.0</version>
    <relativePath>../parent/pom.xml</relativePath>
</parent>

6. 仓库配置

<repositories>
    <repository>
        <id>central</id>
        <name>Central Repository</name>
        <url>https://repo.maven.apache.org/maven2</url>
        <releases>
            <enabled>true</enabled>
        </releases>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
    </repository>
    
    <!-- 自定义仓库 -->
    <repository>
        <id>my-repo</id>
        <name>My Repository</name>
        <url>http://example.com/maven-repo</url>
    </repository>
</repositories>

<!-- 插件仓库 -->
<pluginRepositories>
    <pluginRepository>
        <id>central</id>
        <name>Central Plugin Repository</name>
        <url>https://repo.maven.apache.org/maven2</url>
    </pluginRepository>
</pluginRepositories>

7. 配置属性

<properties>
    <!-- 项目属性 -->
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    
    <!-- 依赖版本 -->
    <spring.version>5.3.8</spring.version>
    <junit.version>4.13.2</junit.version>
    
    <!-- 自定义属性 -->
    <custom.property>value</custom.property>
</properties>

三、高级配置

1. Profile配置

<profiles>
    <profile>
        <id>dev</id>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
        <properties>
            <env>development</env>
        </properties>
    </profile>
    
    <profile>
        <id>prod</id>
        <properties>
            <env>production</env>
        </properties>
        <build>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-surefire-plugin</artifactId>
                    <configuration>
                        <skipTests>true</skipTests>
                    </configuration>
                </plugin>
            </plugins>
        </build>
    </profile>
</profiles>

2. 资源过滤

覆盖默认行为‌：一旦在 POM 中定义了元素，默认的 src/main/resources 目录‌不再自动包含‌。必须在此元素内显式重新指定它，否则默认资源不会被复制

添加额外目录‌：可以将项目其他位置的目录（如 config/, src/main/config）添加为资源目录。

‌精确控制文件‌：通过和子元素，可以精细控制哪些文件需要复制、哪些文件需要忽略（例如只包含特定后缀文件，或排除临时文件）

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <filtering>true</filtering>
            <includes>
                <include>**/*.xml</include>
                <include>**/*.properties</include>
                <include>**/*.json</include>
                <include>**/*.yaml</include>
                <include>**/*.xlsx</include>
                <include>**/*.pptx</include> 
                <include>**/*.sql</include> 
            </includes>
        </resource>
    </resources>
    <testResources>
    	<testResource>
            <directory>src/test/resources</directory>
         <includes>
                <include>**/*.xml</include>
                <include>**/*.properties</include>
                <include>**/*.json</include>
                <include>**/*.yaml</include>
                <include>**/*.xlsx</include>
                <include>**/*.pptx</include> 
                <include>**/*.sql</include> 
            </includes>
    	</testResource>  
    </testResources>     
</build>

3. 自定义生命周期

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-antrun-plugin</artifactId>
            <version>1.8</version>
            <executions>
                <execution>
                    <id>copy-resources</id>
                    <phase>process-resources</phase>
                    <goals>
                        <goal>run</goal>
                    </goals>
                    <configuration>
                        <target>
                            <copy file="src/main/config/config.xml" 
                                  tofile="${project.build.outputDirectory}/config.xml"/>
                        </target>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>