本文介绍如何在 Maven 多模块项目中将重复的插件配置提取至父 POM 统一管理，避免子模块重复定义；通过 声明通用配置，并在子模块中仅声明插件坐标即可继承全部配置，兼顾一致性与灵活性。
本文介绍如何在 maven 多模块项目中将重复的插件配置提取至父 pom 统一管理，避免子模块重复定义；通过 `
在典型的 Maven 多模块结构中（如 root → my-modules → module1/module2），若多个子模块需执行相同构建任务（例如代码格式化、静态检查、资源过滤等），直接在每个子模块的 pom.xml 中复制粘贴插件配置不仅冗余，更易引发版本不一致和维护困难。Maven 提供了两种成熟且推荐的方式实现插件配置的集中化管理，二者适用场景略有不同：
✅ 方式一：在中间父 POM（如 my-modules）中直接配置插件
将插件声明置于 my-modules/pom.xml 的 <build><plugins></plugins></build> 中。由于 Maven 的继承机制，所有继承该 POM 的子模块（module1、module2 等）会自动继承并执行该插件。
优点：配置即生效，无需子模块额外声明；适合所有子模块必须无条件执行该插件的场景。
⚠️ 注意：若某子模块需跳过该插件，须显式配置 <executions><execution><phase>none</phase></execution></executions> 或使用 <skip>true</skip>（取决于插件是否支持）。
✅ 方式二：在根 POM 中使用 <pluginmanagement></pluginmanagement> + 子模块按需启用（推荐）
这是更灵活、更符合 Maven 最佳实践的方式：
- 在
root/pom.xml的<build><pluginmanagement></pluginmanagement></build>中声明插件坐标与完整配置（含<version></version>和<configuration></configuration>），此时不会自动执行； - 在各子模块（如
module1/pom.xml）的<build><plugins></plugins></build>中仅声明<groupid></groupid>和<artifactid></artifactid>，即可继承父 POM 中定义的全部配置（包括版本与参数）。
示例代码如下：
root/pom.xml（声明配置）
<build><pluginmanagement><plugins><plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-checkstyle-plugin</artifactid><version>3.3.1</version><configuration><configlocation>checkstyle-rules.xml</configlocation><failonviolation>false</failonviolation></configuration></plugin></plugins></pluginmanagement></build>
module1/pom.xml（按需启用）
<build><plugins><plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-checkstyle-plugin</artifactid><!-- 无需 version 和 configuration，自动继承 root 中定义 --></plugin></plugins></build>
✅ 优势总结：
- 配置一处，全局可控：版本升级、参数调整仅需修改
pluginManagement区域； - 子模块自主权高：可选择性启用/禁用插件，也可在子模块中覆盖特定
<configuration></configuration>（如为module2指定不同规则文件）； - 符合“约定优于配置”原则，降低出错概率。
? 重要提示：
-
<pluginmanagement></pluginmanagement>本身不触发插件执行，它仅提供“模板”；必须在子模块的<plugins></plugins>中显式引用才能生效； - 若子模块未声明该插件，则完全不受影响——这正是其安全性的体现；
- 对于生命周期绑定（如
<executions></executions>），同样可在pluginManagement中预设，子模块可继承或重写。
综上，对于您描述的 my-modules 及其子模块结构，优先推荐方式二：将通用插件配置放入 root/pom.xml 的 <pluginmanagement></pluginmanagement>，再在各子模块中轻量启用。此举既消除重复、保障一致性，又保留模块级定制能力，是大型多模块项目可持续演进的关键实践。
