Kotlin 注解处理：KSP 与编译元数据编程

使用 Kotlin Symbol Processing (KSP) 代替 kapt，高效解析源码符号并生成代码。 · 难度：入门 · +10XP

Kotlin 注解处理：KSP 与编译元数据编程

KSP 是新一代注解处理器，直接分析 Kotlin 语法树而非 Java 桩代码，速度提升 2 倍以上。本教程将带你从零创建 KSP 处理器：定义 @Builder 注解，自动为数据类生成构建器。你将学习如何遍历 KSClassDeclaration 的成员属性、解析泛型参数、以及用 CodeGen 生成文件。同时对比 kapt 的局限性，探讨 KSP 如何保留 Kotlin 特有语法（如密封类、内联类）。

// KSP 处理器示例
class BuilderProcessor : SymbolProcessor {
    override fun process(resolver: Resolver): List<KSAnnotated> {
        val symbols = resolver.getSymbolsWithAnnotation("com.example.Builder")
        symbols.filterIsInstance<KSClassDeclaration>().forEach { clazz ->
            val file = CodeGenerator.createFile(
                Dependencies(false, clazz.containingFile!!),
                clazz.packageName, "${clazz.simpleName}Builder"
            )
            // 写入构建器代码...
        }
        return emptyList()
    }
}