annotationProcessor是编译期专用通道，仅参与注解处理阶段、不进classpath、不打包进APK；implementation是运行时依赖主干，既参与编译又进入运行时类路径，两者维度不同、无继承关系。
annotationProcessor 是编译期专用通道，implementation 是运行时依赖主干
两者根本不在同一维度：前者只参与注解处理阶段，不进 classpath、不打包进 APK；后者是常规依赖，既参与编译又进入运行时类路径。混淆点常来自名字——annotationProcessor 听起来像“一种 processor 的 implementation”，但实际它和 implementation 没有继承或包含关系，只是共用同一个 dependencies 块。
典型错误现象：Cannot find symbol @BindView 或 Annotation processor not found，往往是因为把 ButterKnife、Dagger、Room 的注解处理器错写成 implementation，导致编译器压根没触发处理逻辑。
-
annotationProcessor只在 javac 编译阶段激活，用于生成代码（如XXX_ViewBinding.java），不参与运行时，也不会出现在 final APK 的 classes.dex 中 -
implementation会同时加入编译 classpath 和运行时 classpath，最终打包进 APK/AAR - 某些库需「双写」：注解本身用
implementation（让业务代码能写@Inject），处理器用annotationProcessor（让编译器能解析并生成代码）
Room、Dagger、ButterKnife 等库必须分开声明
以 Room 为例，androidx.room:room-compiler 是注解处理器，必须走 annotationProcessor；而 androidx.room:room-runtime 是运行时依赖，必须走 implementation。漏掉前者，@Dao 不生成实现类；漏掉后者，运行时报 NoClassDefFoundError。
常见错误配置：
dependencies {
// ❌ 错误：全塞 implementation，processor 不生效
implementation 'androidx.room:room-runtime:2.6.1'
implementation 'androidx.room:room-compiler:2.6.1' // 这行无效！
}
正确写法：
dependencies {
implementation 'androidx.room:room-runtime:2.6.1'
annotationProcessor 'androidx.room:room-compiler:2.6.1'
// Kotlin 用户还要加 kapt，不是 annotationProcessor
}
- Kotlin 项目必须用
kapt替代annotationProcessor，否则注解处理器完全不触发 - Gradle 5.0+ 会直接报错：如果在
implementation下声明了含META-INF/services/javax.annotation.processing.Processor的 JAR，构建失败 - AndroidX 的
room-compiler、dagger-compiler、butterknife-compiler都只提供 processor 功能，无 runtime 行为
compileOnly 和 annotationProcessor 容易被混用
compileOnly 是“编译时需要、运行时不打包”的通用配置，比如 Android Support 库的旧版兼容头文件；而 annotationProcessor 是专为 JSR-269 注解处理器设计的隔离通道。两者目的不同，不能互相替代。
典型误用场景：
- 把
javax.annotation:javax.annotation-api写成annotationProcessor→ 失效，应改用compileOnly - 把
com.google.dagger:dagger-compiler写成compileOnly→ 编译器找不到 Processor 类，@Component不生成代码 -
annotationProcessor不支持传递依赖，其依赖项不会自动拉取，必要时需手动补全（如 AutoService 需额外加annotationProcessor 'com.google.auto.service:auto-service:1.1.1'）
为什么 kapt 不能用 annotationProcessor 替代
Kotlin 编译流程分两步：Kotlin 编译器（kotlinc）先处理 .kt 文件，再交由 javac 处理生成的 .java（如有）。但标准 annotationProcessor 只对 javac 生效，对 kotlinc 无感知。所以 Kotlin 必须用 kapt 插件接管整个流程，把注解处理提前到 kotlin 编译阶段。
关键区别：
-
annotationProcessor→ 仅 Java 模块有效，绑定 javac -
kapt→ Kotlin 模块必需，会启动独立的 annotation processing task，并生成 stubs 让 kotlinc 能识别 - 混用风险：在 Kotlin 模块里写
annotationProcessor，构建不报错但处理器静默失效，@Inject字段始终为 null
真正容易被忽略的是：即使模块里只有 Java 文件，只要项目启用了 Kotlin 插件（apply plugin: 'kotlin-android'），也必须用 kapt，否则注解处理器不会被调用。
