Kotlin 中如何标记未使用的参数

1. 概述

本文将介绍在 Kotlin 中如何处理函数或 Lambda 表达式中未使用的参数。

虽然最佳实践是移除无用参数，但在实际开发中，出于兼容性考虑，我们有时不得不保留它们。本文会告诉你如何优雅地“告诉编译器：我知道这个参数没用，但请别报警”——避免编译警告的同时保持代码整洁。

理想情况下，我们应该从函数签名中删除未使用的参数。但现实往往更复杂，尤其是在维护一个被多个大型项目依赖的核心库时。

✅ 典型场景：
假设你正在迭代一个被数十个服务依赖的公共 SDK。如果贸然删除某个接口中的参数，会导致所有调用方编译失败——这就是所谓的“破坏性变更”（breaking change）。

⚠️ 因此，在过渡期，我们需要暂时保留这些参数，即使它们当前不再被使用。

然而，Kotlin 编译器非常敏感，会对未使用的参数发出警告：

fun paramInFunction(num: Int, magic: String) {
    println("We only use the Int parameter: $num")
}

编译时你会看到类似提示：

/.../UnusedParameter.kt:3:31
Kotlin: Parameter 'magic' is never used

这虽然不影响运行，但满屏警告不利于排查真正的问题。接下来我们就来解决它。

Kotlin 提供了 @Suppress("UNUSED_PARAMETER") 注解，用于显式抑制未使用参数的警告。

你可以将其标注在单个参数上：

fun paramInFunction2(num2: Int, @Suppress("UNUSED_PARAMETER") magic2: String) {
    println("We only use the Int parameter: $num2")
}

也可以直接标注在整个函数上，适用于多个参数都不使用的情况：

@Suppress("UNUSED_PARAMETER")
fun paramInFunction3(num3: Int, magic3: String) {
    println("We only use the Int parameter: $num3")
}

✅ 效果：加上注解后，编译器不会再报“Parameter is never used”。

💡 小贴士：这种方式适用于普通函数、成员函数、扩展函数等所有标准函数形式。

❌ 注意事项：

Lambda 场景略有不同。来看一个常见例子：

listOf("Kotlin", "Java", "Python").forEachIndexed { idx, value -> 
    println("We only print the index of the element: $idx") 
}

编译器会提醒：

Kotlin: Parameter 'value' is never used, could be renamed to _

⚠️ 踩坑点：你可能会尝试这样加注解：

listOf("Kotlin", "Java", "Python").forEachIndexed { idx, @Suppress("UNUSED_PARAMETER") value -> ... }

结果会报错：

Kotlin: Unexpected tokens.

❌ 原因：Lambda 参数不支持直接使用 @Suppress 注解。

✅ 正确做法：使用下划线 _ 替代未使用的参数名！

listOf("Kotlin", "Java", "Python").forEachIndexed { idx, _ -> 
    println("We only print the index of the element: $idx") 
}

✅ 编译通过，且无警告。

📌 核心规则：在 Kotlin 中，_ 是一种语言级别的“占位符”，表示“我故意忽略这个值”。不仅可用于 Lambda，还可用于解构声明中忽略某些字段。

处理未使用参数的关键在于区分上下文：

场景	推荐方式
普通函数	使用 `@Suppress("UNUSED_PARAMETER")` 注解
Lambda 表达式	将参数命名为 `_`
解构赋值	使用 `_` 忽略不需要的字段

📌 最佳实践建议：