一、KAPT的“慢”时代，该结束了

在Android开发中，KAPT曾是Kotlin项目中处理注解的“临时方案”。它通过将Kotlin代码转换为Java stub，再交由Java APT处理，实现注解处理。但这个过程存在明显的性Neng瓶颈：每次注解处理dou需要先生成Java stub，再进行处理，这不仅串行执行，而且无法增量构建，导致整体构建时间被严重拖慢。

在大型项目中，KAPT相关任务往往占据30%以上的全量构建时间。随着项目复杂度的提升，这种“先生成再处理”的模式成为构建时间的瓶颈之一。而KSP的出现，为这一问题提供了根本性解决方案。

二、KSP：Kotlin原生注解处理的未来

KSP是JetBrains推出的KAPT替代方案，它直接在Kotlin编译器的AST层面工作，跳过Java stub生成，实现并行、增量处理，从而显著提升构建效率。KSP的引入，意味着我们终于Ke以告别KAPT的“串行+全量”处理模式，拥抱geng高效的构建方式。

1. KSP迁移的收益

使用KSP后构建时间可提升约40%，尤其在大型项目中，这种提升geng为明显。改一个Room DAO，原来需要近一分钟，迁移后不到10秒，每天节省的时间累计起来非常可观。在多模块/Monorepo项目中，KSP的配置有一些额外注意点，但整体收益非常显著。

2. KSP迁移步骤

迁移KAPT到KSP的步骤如下：

升级Kotlin到1.9+

确保Kotlin版本 ≥ 1.9，AGP版本 ≥ 8.0，K2编译器默认生效

迁移核心库：Room → Hilt → 其余

彻底移除KAPT插件

3. KSP与KAPT的对比

KAPT路径Kotlin → Java Stub生成→ Java APT处理 → 生成代码

KSP路径Kotlin → 直接读取KSP API→ 生成代码

4. KSP迁移配置示例

// build.gradle.kts 
plugins {
    id version "1.8.0" apply false
}

// app/build.gradle.kts
plugins {
    // 移除 KAPT
    // id
    id
    id
}
dependencies {
    implementation
    // kapt → 改为:
    ksp
}
  

5. KSP支持状态

当前主流库的KSP迁移状态和配置：

Hilt KSP支持Yistable，迁移步骤：

同时保留KAPT，只对1-2个影响小的库试迁移，验证构建产物

所有处理器迁移完成后从plugins{}移除kotlin-kapt，清理残留kapt{}块

6. KSP与K2编译器

Kotlin 1.9里K2编译器Yi完全稳定。Ru果你的项目还没开启，这是迁移KSP后的下一个优化点。配合K2编译器，改几行配置，构建时间可Neng直接少掉三分之一。这是投入产出比Zui高的一类工程化升级——不需要重构业务代码，不需要评审，只需要工程师花半天时间跑一遍迁移流程。

7. KSP迁移配置

Room 2.6+正式支持KSP，需注意room.schemaLocation配置方式有变化：

KSP新配置方式：

dependencies {
    implementation
    ksp
}

ksp {
    arg
    arg  // 启用增量处理
}
      

8. KSP与CI构建优化

KSP的增量处理配合Gradle Build CacheKe以显著减少CI时间。典型pipeline配置：

分支A→ 单元测试分支B→ Lint检查 + APK编译

代码提交↓Gradle Build Cache恢复↓KSP增量处理↓

↓编译产物

↓产物归档 + Cache写回

9. KSP与Moshi

随着Moshi alpha完全抛弃KAPT，生产版本也Yi支持KSP，且从KAPT迁移时无需修改业务代码：

// 移除旧的KAPT处理器
// kapt
// 添加KSP处理器
ksp
  

10. KSP与Hilt

Hilt KSP支持Yistable，迁移步骤：

迁移核心库：Room → Hilt → 其余

所有处理器迁移完成后从plugins{}移除kotlin-kapt，清理残留kapt{}块

11. KSP与K2编译器

K2编译器在Kotlin 1.9+默认开启，确认版本即可

验证当前编译器版本

./gradlew :app:compileDebugKotlin --info | grep "Using Kotlin"
  

12. KSP与K2编译器的兼容性

需要关注的兼容性问题：

Ru果用到了某些依赖反射行为的库，需测试回归

部分Kotlin编译器插件需确认版本与K2对齐

13. KSP与K2编译器的配置

关键gradle.properties配置：

org.gradle.caching=true
org.gradle.parallel=true
org.gradle.configureondemand=true
org.gradle.jvmargs=-Xmx4g -XX:+UseParallelGC
ksp.incremental=true
ksp.incremental.log=false
  

14. KSP与K2编译器的收益

关键收益对比：

并行任务：

多个KAPT处理器顺序执行，无法并行

构建缓存命中率低，CI加速效果差

15. KSP与K2编译器的迁移路线图

分阶段推进，风险可控

① 升级Kotlin到1.9+

② 迁移核心库：Room → Hilt → 其余

③ 彻底移除KAPT插件

④ 迁移核心库：Room → Hilt → 其余

16. KSP与K2编译器的迁移步骤

迁移步骤：

① 升级Kotlin到1.9+

② 迁移核心库：Room → Hilt → 其余

③ 彻底移除KAPT插件

④ 迁移核心库：Room → Hilt → 其余

17. KSP与K2编译器的迁移路线图

分阶段推进，风险可控

① 升级Kotlin到1.9+

② 迁移核心库：Room → Hilt → 其余

③ 彻底移除KAPT插件

④ 迁移核心库：Room → Hilt → 其余

18. KSP与K2编译器的迁移路线图

分阶段推进，风险可控

① 升级Kotlin到1.9+

② 迁移核心库：Room → Hilt → 其余

③ 彻底移除KAPT插件

④ 迁移核心库：Room → Hilt → 其余

19. KSP与K2编译器的迁移路线图

分阶段推进，风险可控

① 升级Kotlin到1.9+

② 迁移核心库：Room → Hilt → 其余

③ 彻底移除KAPT插件

④ 迁移核心库：Room → Hilt → 其余

20. KSP与K2编译器的迁移路线图

分阶段推进，风险可控

① 升级Kotlin到1.9+

② 迁移核心库：Room → Hilt → 其余

③ 彻底移除KAPT插件

④ 迁移核心库：Room → Hilt → 其余

21. KSP与K2编译器的迁移路线图

分阶段推进，风险可控

① 升级Kotlin到1.9+

② 迁移核心库：Room → Hilt → 其余

③ 彻底移除KAPT插件

④ 迁移核心库：Room → Hilt → 其余

22. KSP与K2编译器的迁移路线图

分阶段推进，风险可控

① 升级Kotlin到1.9+

② 迁移核心库：Room → Hilt → 其余

③ 彻底移除KAPT插件

④ 迁移核心库：Room → Hilt → 其余

23. KSP与K2编译

---