1. 概述
在调用参数较多的函数时，代码可读性可能变差，甚至出现参数顺序传错的问题。随着函数可选参数数量的增加，使用函数重载来提供默认值的方式也会变得难以维护。
Kotlin 提供了两个语言特性来解决这些问题：命名参数（Named Arguments）和默认参数（Default Arguments）。
本文将详细介绍这两个特性，并通过示例展示它们如何提升代码的可读性和可维护性。
2. 位置参数的问题
位置参数（Positional Arguments）是我们日常开发中最常见的参数传递方式。它们必须按照函数声明的顺序传入，顺序和类型都必须严格匹配。
2.1. 位置参数的可读性问题
考虑如下函数定义：
fun resizePane(newSize: Int, forceResize: Boolean, noAnimation: Boolean) {
println("The parameters are newSize = $newSize, forceResize = $forceResize, noAnimation = $noAnimation")
}
如果我们这样调用：
resizePane(10, true, false)
在没有 IDE 提示或查看函数定义的情况下，很难一眼看出每个参数的含义。尤其是布尔值，意义不明确，容易传错顺序。
当参数数量增加或允许传入 null 时，这个问题会更加严重。
3. Kotlin 命名参数
在 Kotlin 中调用函数时，可以显式地为参数命名，参数名必须与函数定义中的一致。
3.1. 使用命名参数调用函数
我们重写上面的调用方式：
resizePane(newSize = 10, forceResize = true, noAnimation = false)
这样写更清晰、更易验证，调用者一眼就能看出每个参数的用途。
3.2. 命名参数的顺序无关性
与位置参数不同，命名参数可以以任意顺序传入。例如：
resizePane(newSize = 11, noAnimation = false, forceResize = true)
或者：
resizePane(forceResize = true, newSize = 12, noAnimation = false)
都合法且等效。
3.3. 混合使用命名与位置参数
虽然命名参数提高了可读性，但有时我们希望保持简洁。Kotlin 允许我们在同一个调用中混合使用命名和位置参数。
⚠️ 注意：在 Kotlin 1.3 中，位置参数必须写在命名参数之前。但 Kotlin 1.4 及以后版本取消了这一限制，只要参数顺序在逻辑上是正确的即可。
例如：
resizePane(20, true, noAnimation = false)
或者：
resizePane(newSize = 20, true, noAnimation = false)
甚至可以：
resizePane(40, forceResize = true, false)
这些写法都是合法的，且效果一致。
4. 默认参数
默认参数允许我们为函数参数指定默认值。如果调用时未传入该参数，则使用默认值。
这在 Java 中无法实现，通常需要通过方法重载或手动判断 null 值实现。Kotlin 原生支持默认参数，大大简化了代码结构。
4.1. 声明默认参数
在函数定义中，使用 = 为参数指定默认值：
fun connect(url: String, connectTimeout: Int = 1000, enableRetry: Boolean = true) {
println("The parameters are url = $url, connectTimeout = $connectTimeout, enableRetry = $enableRetry")
}
4.2. 调用默认参数函数
调用时可以省略具有默认值的参数：
connect("http://www.baeldung.com")
该调用将使用 connectTimeout = 1000 和 enableRetry = true。
也可以只省略部分参数：
connect("http://www.baeldung.com", 5000)
此时 enableRetry 使用默认值。
4.3. 跳过中间参数
如果我们想跳过中间的参数（如 connectTimeout），直接传最后一个参数 enableRetry，会发生编译错误：
connect("http://www.baeldung.com", false) // ❌ 编译错误
因为第二个参数期望是 Int，而我们传入了 Boolean。
✅ 正确做法是使用命名参数：
connect("http://www.baeldung.com", enableRetry = false)
这样就能跳过中间参数，只传最后一个。
5. 默认参数与函数重写
默认参数不仅适用于普通函数，也适用于继承和重写场景。
5.1. 继承默认参数值
子类重写函数时，会继承父类函数中定义的默认参数值。
例如：
open class AbstractConnector {
open fun connect(url: String = "localhost") {
println("Connecting to $url")
}
}
class RealConnector : AbstractConnector() {
override fun connect(url: String) {
println("Connecting to $url")
}
}
此时我们仍然可以不传参数调用：
val connector = RealConnector()
connector.connect() // ✅ 使用父类定义的默认值 "localhost"
5.2. 子类不能覆盖默认值
如果你尝试在子类中为参数重新设置默认值：
class RealConnector : AbstractConnector() {
override fun connect(url: String = "www.baeldung.com") { // ❌ 编译错误
println("Connecting to $url")
}
}
Kotlin 会报错：不允许在重写函数中重新指定默认参数值。
⚠️ 所以如果你想修改默认值，必须在父类中修改。
6. 总结
本文介绍了 Kotlin 中两个非常实用的语言特性：
| 特性 | 优势 |
|---|---|
| 命名参数 | 提升可读性，避免参数顺序混淆 |
| 默认参数 | 简化函数重载，减少冗余代码 |
通过结合使用命名参数与默认参数，我们可以写出更清晰、更灵活的函数调用，尤其在参数较多或需要跳过某些参数时尤为有用。
✅ 最佳实践建议：
- 参数多于 3 个时优先使用命名参数
- 可选参数尽量使用默认值
- 避免在子类中试图覆盖默认参数值
完整示例代码可在 GitHub 获取。