【Kotlin】kapt と ksp の違いを整理する

Last updated at 2025-09-26Posted at 2025-09-26

Kotlin プロジェクトでアノテーション処理を使うとき、
長らく kapt が主流でしたが、最近は ksp（Kotlin Symbol Processing）が推奨される流れになっています。
この記事では両者の違いと、なぜ ksp が登場したのか歴史を含めて整理します。

Java には JSR 269 に基づく APT（Annotation Processing Tool） が存在し、
Dagger, ButterKnife, Room など多くのライブラリがコード生成に利用していました。

Kotlin 1.0（2016年）リリース当初は、既存の Java APT を Kotlin プロジェクトでも動かしたいニーズが強かった
JetBrains が kapt (Kotlin Annotation Processing Tool) を開発し、Kotlin → Java スタブを生成して APT を利用できるようにした
これにより Kotlin でも Dagger, Room などのライブラリをそのまま使えた
ただし スタブ生成のオーバーヘッド によりビルドが遅いという課題があった

現在、Google の公式ドキュメントや Android 開発ガイドでも KSP を使うことが推奨 されています。

kapt (Kotlin Annotation Processing Tool) は、
Kotlin で Java の標準アノテーションプロセッサ を利用するための仕組みです。

KSP (Kotlin Symbol Processing) は、Google が公式に提供している Kotlin ネイティブのアノテーション処理 API。
kapt の課題を解決するために作られた後継です。

plugins {
    kotlin("kapt")
}

dependencies {
    kapt("com.google.dagger:hilt-compiler:2.x")
}

plugins {
    id("com.google.devtools.ksp")
}

dependencies {
    ksp("com.google.dagger:hilt-compiler:2.x")
}

Room, Hilt, Moshi, Retrofit などはすでに ksp に対応済み。
新規プロジェクトなら ksp を選ぶのがベストです。

参考: