是否存在注解可在Kotlin回调参数未使用时生成警告？

核心问题 #

Kotlin允许用it隐式引用单参数回调的参数，这会导致常规lint的「未使用参数」检测失效——哪怕回调里完全没用到这个参数，只要没显式声明变量，lint就不会报警，很容易忽略掉方法传递的关键值。

通用解决方案 #

你可以通过自定义注解+静态代码分析工具实现需求，不需要依赖特定库：

1. 定义「必须使用」的参数注解
   创建一个仅在源码阶段生效的注解，标记回调中必须被使用的参数：

   @MustBeDocumented
   @Retention(AnnotationRetention.SOURCE)
   @Target(AnnotationTarget.VALUE_PARAMETER)
   annotation class MustUseParameter
   

2. 标记回调参数
   在你的方法的回调参数上添加这个注解：

   fun fetchData(callback: (@MustUseParameter Result) -> Unit) {
       // 模拟获取数据并传递给回调
       callback(Result.Success("data"))
   }
   

3. 配置静态分析工具检测
   常规Kotlin lint的unused规则不识别it的隐式未使用，所以需要用Detekt或自定义Android Lint规则来实现检测逻辑：

   • 对于Detekt：编写自定义规则，扫描带有@MustUseParameter注解的参数，检查其所在lambda中是否实际使用了该参数（包括隐式的it是否被引用）。
   • 对于Android Lint：编写自定义Detector，遍历lambda的语法树，确认带有注解的参数是否被访问。

替代快速方案 #

如果不想写自定义规则，也可以通过强制显式声明参数的方式规避it的问题：

• 在方法文档中明确要求回调必须显式声明参数（而非用it），配合常规lint的unused检查，只要参数被显式声明但未使用，lint就会触发警告。

关于Jetpack Compose的Scaffold提示 #

Compose的Scaffold未使用PaddingValues的警告，是Compose专属lint规则实现的（针对@Composable函数的回调参数），但核心思路和上面的通用方案一致：通过标记参数+自定义静态分析来强制检查使用情况。

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