关于kapt的aptMode用途、三种取值细节及stubs含义的技术问询

我来给你详细拆解一下kapt的aptMode相关问题～

首先，kapt是Kotlin官方提供的注解处理工具，而aptMode的核心作用就是控制注解处理过程中生成代码的类型与处理逻辑，简单来说就是决定注解处理器是生成完整可运行的实现代码，还是仅生成用于类型检查的存根类，以此在编译速度和功能完整性之间做平衡。

它的三种取值具体信息如下：

• default：这是默认启用的模式，也是日常开发中最常用的。在该模式下，注解处理器会同时生成完整的实现代码和Kotlin风格的存根类——存根类用于让Kotlin编译器提前做类型检查，确保代码的语法和类型正确性，而完整实现代码则保证最终构建出的程序可以正常运行。这种模式完美兼顾了编译正确性和功能完整性，适合绝大多数开发场景。

• stubs：这个模式的核心特点是只生成存根类，不生成完整的实现代码。那什么是存根类呢？你可以把它理解成一个“空架子”——只有类、方法、属性的签名（比如类名、方法名、参数类型、返回值类型），但没有任何实际的方法体逻辑。这种模式的最大优势是编译速度极快，因为跳过了完整代码生成的耗时步骤，非常适合快速迭代开发的场景（比如你只是修改了非注解相关的代码，不想等待完整的注解处理编译流程）。不过要注意：用这个模式生成的代码是无法运行的，因为没有实际的业务逻辑实现。

• apt：这个模式会完全依赖Java原生的APT（Annotation Processing Tool）来处理注解，不会生成Kotlin专属的存根类。它会让Java注解处理器直接生成Java代码，再由Kotlin编译器去处理这些生成的代码。这种模式主要是为了兼容一些只支持Java APT的老旧注解库，现在主流的注解框架基本都已经适配了kapt，所以这个模式的使用场景比较有限。

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