12.2 Kotlin 编译器插件 on 编程那些事儿

12.2.1 编译器插件

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/compiler-plugins-overview.html

12.2.1 编译器插件

编译器插件会挂接到编译过程中，在代码被编译时对其进行分析或修改，而无需修改编译器本身。例如，它们可以为代码添加注解，或生成新代码以使其与其他框架或 API 兼容。

12.2.2 All-open 编译器插件

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/all-open-plugin.html

12.2.2 All-open 编译器插件

Kotlin 中的类及其成员默认是 final 的，这使得使用 Spring AOP 等要求类为 open 的框架和库时不太方便。all-open 编译器插件让 Kotlin 适应这些框架的要求：使带有特定注解的类及其成员无需显式写出 open 关键字就是开放的。

12.2.3 kapt 编译器插件

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/kapt.html

12.2.3 kapt 编译器插件

如果你符合以下情况，请使用 kapt：* 你有一个 Maven 项目。* 你有一个 Gradle 项目，但所需的 Java 注解处理器尚不支持 KSP。查看受支持的库列表。* 如果你符合以下情况，请使用 KSP：* 你有一个 Gradle 项目，且所需的 Java 注解处理器支持 KSP。* 你想创建自己的注解处理器。

kapt 编译器插件让你可以在 Kotlin 中使用现有的 Java 注解处理器，并同时支持 Maven 和 Gradle。它会根据 Kotlin 源码生成桩文件，然后在这些桩文件上运行 Java 注解处理器。

12.2.4 Lombok 编译器插件

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/lombok.html

12.2.4 Lombok 编译器插件

Alpha

Kotlin Lombok 编译器插件允许 Kotlin 代码在同一个 Java/Kotlin 混合模块中生成并使用 Java 的 Lombok 声明。如果你从另一个模块调用这类声明，那么编译那个模块时不需要使用该插件。

12.2.5 No-arg 编译器插件

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/no-arg-plugin.html

12.2.5 No-arg 编译器插件

no-arg 编译器插件会为带特定注解的类生成一个额外的无参构造函数。

生成的构造函数是合成的，因此不能从 Java 或 Kotlin 中直接调用，但可以通过反射调用。

12.2.6 Power-assert 编译器插件

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/power-assert.html

12.2.6 Power-assert 编译器插件

实验性

Kotlin Power-assert 编译器插件通过提供带有上下文信息的详细失败消息来改善调试体验。它通过在失败消息中自动生成中间值，简化了编写测试的过程。它帮助你理解测试为何失败，而无需复杂的断言库。

12.2.7 SAM-with-receiver 编译器插件

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/sam-with-receiver-plugin.html

12.2.7 SAM-with-receiver 编译器插件

sam-with-receiver 编译器插件会把带注解的 Java “单一抽象方法”（SAM）接口方法的第一个参数变成 Kotlin 中的接收者。只有在把该 SAM 接口作为 Kotlin lambda 传入时，这种转换才有效，对 SAM 适配器和 SAM 构造函数都适用（更多细节请参阅 SAM 转换文档）。

12.2.8 自定义编译器插件

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/custom-compiler-plugins.html

12.2.8 自定义编译器插件

警告： Kotlin 编译器插件 API 不稳定，并且每个版本都会引入破坏性变更。

在创建自己的自定义编译器插件之前，请先查看可用编译器插件列表，看看是否已有适合你用例的插件。

你还可以确认是否能用 Kotlin Symbol Processing (KSP) API 或 Android lint 这类外部 linter 达到目的。