如何为Kotlin文件级函数添加Java类级自定义注解？

我之前也碰到过一模一样的场景——把Java静态工具类转成Kotlin文件级函数后，原来的类级注解不知道怎么迁移。其实Kotlin的文件级注解语法刚好能解决这个问题，具体做法如下：

核心思路 #

Kotlin的文件级函数会被编译器自动生成一个类（默认是「文件名+Kt」的格式，比如Utils.kt会生成UtilsKt），我们需要给这个自动生成的类加上目标注解，这时候就要用到文件级注解并明确指定注解目标为类。

具体步骤及代码示例 #

1. 先确认你的自定义注解@MyCustomAspect的保留策略（@Retention）和Java版本一致，比如是RetentionPolicy.RUNTIME或者CLASS，这样注解处理器才能正常识别到它。

2. 在Kotlin文件的最顶部（包声明之后、函数之前）添加文件级注解：

// Utils.kt
package com.example

// 指定该注解作用于自动生成的类
@file:Target(AnnotationTarget.CLASS)
// 添加上你的自定义类级注解
@file:MyCustomAspect

fun doStuff() {
    println("Hello")
}

进阶：自定义生成的类名（可选） #

如果希望生成的类名和原来的Java类完全一致（比如还是Utils而不是UtilsKt），可以搭配@file:JvmName注解做兼容：

// Utils.kt
package com.example

@file:JvmName("Utils")
@file:Target(AnnotationTarget.CLASS)
@file:MyCustomAspect

fun doStuff() {
    println("Hello")
}

这样处理后，编译生成的类和你原来的JavaUtils类完全等价，注解处理器也能像处理Java类一样识别到@MyCustomAspect注解。

内容的提问来源于stack exchange，提问作者metacubed