Maven 执行 mvn install 时频繁全量重新编译子模块，根源在于 maven-compiler-plugin 的增量编译机制缺陷；通过禁用 useIncrementalCompilation 可彻底规避该问题。
maven 执行 `mvn install` 时频繁全量重新编译子模块，根源在于 maven-compiler-plugin 的增量编译机制缺陷；通过禁用 `useincrementalcompilation` 可彻底规避该问题。
在多模块 Maven 项目（尤其是 NetBeans Platform 应用）中，mvn compile 能正确识别已编译类并跳过后续执行，但 mvn install 却几乎每次都触发所有子模块的重新编译——即使源码未变更。日志显示类似以下关键线索：
[DEBUG] New dependency detected: .../target/org-jjazz-utilities-1.0-SNAPSHOT.jar [INFO] Changes detected - recompiling the module!
这并非真正检测到源码变更，而是 maven-compiler-plugin（尤其 3.x 版本）在增量编译模式下错误地将上游模块新生成的 SNAPSHOT JAR 视为“依赖变更”，从而强制下游模块重编译。该行为由长期存在的 MCOMPILER-209 缺陷导致，自 2014 年起持续存在，影响广泛却未被修复。
解决方案：显式禁用增量编译
在父 POM 的
<plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-compiler-plugin</artifactid><version>3.10.0</version><configuration><source>11</source><target>11</target><useincrementalcompilation>false</useincrementalcompilation></configuration></plugin>
✅ 效果验证：配置后再次执行 mvn install，第二次构建将如 mvn compile 一样快速完成，各模块均输出 Nothing to compile - all classes are up to date。
⚠️ 注意事项：
- 此设置不影响编译正确性，仅关闭有缺陷的增量判断逻辑；
- 若使用较新版本（如 3.11.0+），仍建议保留该配置，因问题尚未根本修复；
- 不要尝试通过 -Dmaven.compiler.useIncrementalCompilation=false 命令行参数覆盖——该参数不生效，必须在 POM 中硬编码配置。
该方案虽反直觉（“禁用增量”反而提升效率），却是当前最稳定、零副作用的实践方案。对于大型多模块项目，此举可显著缩短 CI 构建时间与本地开发反馈周期。
