kotlin-kapt与annotationProcessor()的核心差异及Kotlin/Java工作机制问询

核心区别 #

• 语言适配范围：annotationProcessor()是Gradle为Java项目提供的注解处理器工具，仅能识别并处理Java代码中的注解；而kotlin-kapt（简称kapt）是Kotlin官方推出的适配工具，专门解决Kotlin代码的注解处理问题，同时兼容Java代码的注解处理。
• Kotlin注解处理能力：annotationProcessor()无法解析Kotlin代码中的注解，哪怕是和Java中相同的注解也会被忽略；kapt会先将Kotlin代码编译为Java Stub（存根文件）——保留类、方法、注解结构但无具体实现的轻量Java文件，让Java注解处理器能识别并处理Kotlin中的注解，打通了Kotlin与Java注解生态的兼容性。
• Gradle配置要求：使用annotationProcessor()无需额外插件，Java项目直接在dependencies中声明annotationProcessor 'xxx'即可；而使用kapt需要先引入Kotlin kapt插件（id 'org.jetbrains.kotlin.kapt'），再通过kapt 'xxx'配置注解处理器依赖。

工作行为细节 #

annotationProcessor() 在Java/Kotlin中的表现 #

• Java项目中：编译阶段会扫描所有Java源文件，识别带有指定注解的元素（类、方法、字段等），调用对应的注解处理器生成辅助代码（比如Dagger的组件类、Room的DAO实现类），生成的代码会和原Java代码一起编译为字节码。
• Kotlin/Java混合项目中：仅处理Java代码中的注解，完全无视Kotlin代码里的注解，导致依赖注解生成的功能在Kotlin代码中失效。

kapt 在Java/Kotlin中的表现 #

• Kotlin项目中：处理流程分为三步：
  1. 将Kotlin源码编译为Java Stub文件，确保注解信息能被Java注解处理器识别；
  2. 调用指定的注解处理器处理Stub文件中的注解，生成辅助代码；
  3. 将原Kotlin源码、生成的辅助代码一起编译为最终的字节码。
• Kotlin/Java混合项目中：同时处理Kotlin和Java代码中的注解，无需额外配置annotationProcessor()，一套kapt配置就能覆盖两种语言的注解处理需求。

举个实际例子：如果在Kotlin项目中用Room，要是配置annotationProcessor 'androidx.room:room-compiler:x.x.x'，Room的注解（比如@Dao、@Entity）在Kotlin类中不会被处理，导致编译报错；换成kapt 'androidx.room:room-compiler:x.x.x'后，kapt会生成必要的DAO实现类，项目才能正常运行。

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