本文介绍如何在 Maven 多模块项目中将重复插件配置统一提取至父 POM，通过 机制实现子模块按需继承与复用，避免冗余配置，提升可维护性与一致性。
本文介绍如何在 maven 多模块项目中将重复插件配置统一提取至父 pom，通过 `
在典型的 Maven 多模块结构中（如 root → my-modules → module1/module2），若多个子模块需执行相同构建任务（例如代码格式化、静态检查、资源过滤等），在每个子模块的 pom.xml 中单独配置同一插件不仅违反 DRY 原则，还会导致版本不一致、配置难以同步等问题。Maven 提供了两种成熟且推荐的集中化管理方式，兼顾灵活性与可维护性。
✅ 推荐方案一：在 my-modules（聚合父 POM）中直接声明插件
若所有子模块无条件需要执行该插件目标（如 maven-compiler-plugin 编译），可直接在 my-modules/pom.xml 的 <build><plugins></plugins></build> 中声明插件。此时插件会自动继承并生效于所有子模块（包括 module1、module2 等），无需子模块额外配置：
<!-- my-modules/pom.xml --> <build><plugins><plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-compiler-plugin</artifactid><version>3.11.0</version><configuration><source>17</source><target>17</target></configuration></plugin></plugins></build>
⚠️ 注意：此方式适用于“强制执行”的场景；若某子模块需跳过该插件（如测试模块禁用打包），则需在子模块中显式配置
<executions><execution><phase>none</phase></execution></executions>或使用<skip></skip>参数（取决于插件支持）。
✅ 推荐方案二：在 root POM 中定义 <pluginmanagement></pluginmanagement>，子模块按需启用（更灵活）
当插件行为需差异化控制（如仅部分子模块启用、或不同模块需不同 <configuration></configuration>），应采用 <pluginmanagement></pluginmanagement> + 显式引用模式。该机制不触发执行，仅提供默认配置模板；子模块需在自身 <build><plugins></plugins></build> 中声明 groupId/artifactId，即自动继承父级配置（含 version 和 configuration）：
root/pom.xml
<build><pluginmanagement><plugins><plugin><groupid>com.google.code.maven-replacer-plugin</groupid><artifactid>replacer</artifactid><version>1.5.3</version><configuration><includes><include>src/main/resources/application.properties</include></includes><replacements><replacement><token>@project.version@</token><value>${project.version}</value></replacement></replacements></configuration></plugin></plugins></pluginmanagement></build>
module1/pom.xml
<build><plugins><plugin><groupid>com.google.code.maven-replacer-plugin</groupid><artifactid>replacer</artifactid><!-- 版本、configuration 全部继承自 root 的 pluginManagement --></plugin></plugins></build>
? 优势：子模块可覆盖继承的配置（如
<configuration></configuration>内嵌值），也可通过<executions></executions>自定义绑定阶段；同时保持 root 层统一版本管控，杜绝“版本散落”。
? 最佳实践总结
-
优先使用
<pluginmanagement></pluginmanagement>：适用于绝大多数多模块项目，尤其当团队需长期维护、插件版本频繁升级时； -
避免在 root POM 的
<plugins></plugins>中直接声明插件：除非 root 本身需参与构建（如生成聚合报告），否则易导致意外执行； -
验证继承效果：运行
mvn help:effective-pom -pl module1可查看module1实际生效的完整 POM，确认插件配置是否正确继承； -
慎用
<inherited>false</inherited>：仅在极少数需阻断继承时设置，通常不应修改默认行为。
通过合理运用 <pluginmanagement></pluginmanagement>，您不仅能消除重复配置，更能构建出层次清晰、易于演进的 Maven 构建体系。
