Maven ＜parent＞ 标签的作用及使用详解

在使用 Maven 进行项目构建时，<parent> 标签是一个非常重要的配置元素。它允许子模块继承父模块的配置，从而实现一致性和配置管理的简化。本文将详细介绍 <parent> 标签的主要作用，并通过示例来说明其使用方式和关键点。

<parent> 标签的主要作用

<parent> 标签的作用主要体现在以下几个方面：

1. 继承父模块的配置
   • 依赖管理 (dependencyManagement)：子模块可以继承父模块中定义的依赖管理配置。在子模块的 dependencies 中引用依赖时，如果该依赖在父模块的 dependencyManagement 中已定义，子模块可以省略版本号，自动使用父模块中指定的版本。
   • 插件管理 (pluginManagement)：类似于依赖管理，子模块可以继承父模块中定义的插件管理配置，直接使用这些插件，而无需重新定义版本号。
   • 全局属性：子模块会继承父模块中定义的全局属性，例如 Java 版本、编码格式等。
   • 构建配置：子模块继承父模块中的构建配置，包括构建生命周期、默认目标等。
2. 统一版本和配置管理
   • 在父模块中集中管理依赖和插件版本，可以避免在每个子模块中重复定义这些版本号，确保项目内各模块使用的版本一致。
3. 继承但不自动导入依赖
   • 子模块继承父模块的配置，但不会自动导入父模块中定义的所有依赖。只有当子模块在 dependencies 中显式声明某个依赖时，这个依赖才会被实际导入，并自动使用父模块 dependencyManagement 中定义的版本号（如果有的话）。

示例

假设有一个父模块 parent-module 的 pom.xml 配置如下：

<project>
    <groupId>com.example</groupId>
    <artifactId>parent-module</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
                <version>2.7.0</version>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.1</version>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

子模块 child-module 的 pom.xml 使用 <parent> 标签：

<project>
    <modelVersion>4.0.0</modelVersion>

    <parent>
        <groupId>com.example</groupId>
        <artifactId>parent-module</artifactId>
        <version>1.0-SNAPSHOT</version>
        <relativePath>../pom.xml</relativePath>
    </parent>

    <artifactId>child-module</artifactId>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>
</project>

关键点

• 继承配置：子模块通过 <parent> 标签继承了父模块的配置，特别是 dependencyManagement 中定义的 spring-boot-starter-web 依赖的版本号。
• 显式声明依赖：子模块并不会自动导入父模块的所有依赖，而是需要在 dependencies 中显式声明所需的依赖。
• 插件和构建配置：继承的插件和构建配置如 maven-compiler-plugin 会在子模块的构建过程中应用。

总结

<parent> 标签是 Maven 项目中实现配置继承和统一管理的重要工具。它不仅允许子模块继承父模块的配置，还通过集中管理版本和配置来简化项目维护。不过，需要注意的是，子模块并不会自动导入父模块中的所有依赖，只有显式声明的依赖才会被实际使用。通过合理使用 <parent> 标签，可以有效提高项目的组织性和一致性。