多Maven模块项目中Kotlin Compiler性能不佳问题咨询

我们正从Java迁移至Kotlin，过程中发现：模块中仅添加单个Kotlin文件就会显著拖慢该模块的编译速度。

为复现问题，我们搭建了一个简单的多Maven模块项目，结构为parent下包含Module a、Module b、Module c：

当Module a中有100个Java文件、0个Kotlin文件时，编译耗时如下：

[INFO] a .................................................. SUCCESS [ 2.069 s ]
[INFO] b .................................................. SUCCESS [ 0.350 s]
[INFO] c .................................................. SUCCESS [ 0.118 s]
[INFO] Parent POM ......................................... SUCCESS [ 0.071 s].

仅在Module a中添加1个Kotlin文件后，编译耗时变为：

[INFO] a .................................................. SUCCESS [ 4.757 s]
[INFO] b .................................................. SUCCESS [ 0.121 s]
[INFO] c .................................................. SUCCESS [ 0.104 s]
[INFO] Parent POM ......................................... SUCCESS [ 0.066 s]

模块中添加Kotlin文件的数量对耗时影响不大，添加100个Kotlin文件后，编译耗时增至5.582秒。问题根源似乎是每个模块只要包含Kotlin文件就必须调用Kotlin Compiler。

由于我们的项目包含近600个Maven模块，该问题将大幅增加CI耗时。请问有什么解决方案？Kotlin 2.0 Compiler是否会解决该问题？

一、当前可落地的优化方案 #

• 集中Kotlin代码到特定模块：避免在大量小模块中零散添加Kotlin文件，将Kotlin代码集中到少数模块中，减少需要启动Kotlin编译器的模块数量。
• 启用增量编译：在Maven的Kotlin插件配置中开启增量编译，仅编译修改过的文件以减少重复开销。配置示例：

  <configuration>
      <incremental>true</incremental>
  </configuration>
  

• 并行编译与增量构建：使用Maven并行编译参数（mvn -T 1C clean install）提升多模块编译效率；同时在CI中使用--also-make或--also-make-dependents参数，仅编译受修改影响的模块，避免全量编译。
• 精简Kotlin插件配置：关闭非必需的编译器功能，比如禁用不必要的注解处理、匹配项目实际需求设置JVM目标版本，减少编译器额外工作。
• CI环境缓存编译产物：利用Maven本地仓库缓存或分布式缓存机制，复用已编译的模块产物，避免重复编译。

二、Kotlin 2.0 Compiler的性能改进 #

Kotlin 2.0 Compiler（K2）针对多模块场景的编译性能做了针对性优化，能够缓解该问题：

• 更快的编译器启动速度：K2重构了初始化流程，大幅降低了编译器启动时的开销，对于多模块中频繁启动编译器的场景帮助显著。
• 升级增量编译机制：K2的增量编译逻辑更精准，能进一步缩小需要重新编译的代码范围，同时降低增量校验的成本。
• 全阶段编译效率提升：K2在语法分析、代码生成等核心阶段都做了性能优化，单模块编译速度比旧版K1编译器提升明显，即使是仅含少量Kotlin文件的模块，耗时也会显著降低。

需要注意的是，K2已正式发布，但部分旧特性的兼容性需要提前验证，建议先在测试模块中验证兼容性与实际性能表现后再全量迁移。

内容的提问来源于stack exchange，提问作者Phil