Maven 执行 mvn install 时频繁触发不必要的全量重编译，根源在于 maven-compiler-plugin 的增量编译机制缺陷；通过禁用 useIncrementalCompilation 可彻底规避该问题，恢复预期的增量构建行为。
maven 执行 `mvn install` 时频繁触发不必要的全量重编译，根源在于 `maven-compiler-plugin` 的增量编译机制缺陷；通过禁用 `useincrementalcompilation` 可彻底规避该问题，恢复预期的增量构建行为。
在多模块 Maven 项目（尤其是 NetBeans Platform 类应用）中，开发者常遇到一个反直觉现象：mvn compile 支持高效增量编译（第二次执行几乎瞬时完成），但 mvn install 却每次都会重新编译几乎所有子模块——即使源码未变更。日志显示类似 [INFO] Changes detected - recompiling the module!，且调试信息（mvn -X）揭示其误判依据为上游模块 JAR 文件的时间戳变化（如 org-jjazz-utilities-1.0-SNAPSHOT.jar 更新导致下游模块被强制重编）。
这一行为并非配置错误，而是 maven-compiler-plugin 长期存在的已知缺陷（MCOMPILER-209），自 2014 年报告至今未修复。其根本原因在于增量编译逻辑错误地将 install 阶段生成的 SNAPSHOT JAR 视为“源变更信号”，从而破坏了跨模块依赖的增量判断。
解决方案：显式禁用增量编译
在父 POM 的
<plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-compiler-plugin</artifactid><version>3.10.0</version><configuration><useincrementalcompilation>false</useincrementalcompilation><!-- 其他配置，如 source/target 保持不变 --><source>11</source><target>11</target></configuration></plugin>
✅ 效果验证：配置后执行 mvn install，第二次运行将跳过所有未修改模块的编译，输出 Nothing to compile - all classes are up to date，与 mvn compile 行为一致。
⚠️ 注意事项：
- 此设置仅关闭编译器的“增量扫描”逻辑，不影响 Java 编译本身，也不影响 test-compile 或其他生命周期阶段；
- 若项目使用较新版本插件（如 3.11.0+），该参数默认仍为 true，必须显式覆盖；
- 禁用后，Maven 仍通过标准依赖时间戳比对决定是否跳过编译，逻辑更稳定可靠；
- 不推荐改用 mvn compile && mvn package 替代 install——这会绕过本地仓库部署，破坏模块间 SNAPSHOT 依赖的正确解析。
综上，面对这一持续十年的插件缺陷，主动禁用 useIncrementalCompilation 是最简洁、可靠且零副作用的实践方案，能立即恢复多模块项目的构建效率与可预测性。
