编辑“︁Kotlin默认参数”︁

{{DISPLAYTITLE:Kotlin默认参数}}

'''Kotlin默认参数'''是Kotlin语言中一项强大的功能，允许开发者为函数参数指定默认值。当调用函数时，如果某些参数未被显式传递，则会自动使用这些默认值。这一特性显著减少了方法重载的需求，使代码更加简洁且易于维护。

== 基本概念 ==
在Kotlin中，函数的参数可以定义默认值，语法如下：
<syntaxhighlight lang="kotlin">
fun greet(name: String = "World") {
    println("Hello, $name!")
}
</syntaxhighlight>
当调用`greet()`时，若未提供参数，则输出`Hello, World!`；若调用`greet("Alice")`，则输出`Hello, Alice!`。

=== 关键特性 ===
* '''减少重载''': 无需为不同参数组合编写多个重载函数。
* '''灵活性''': 调用时可选择性省略部分参数。
* '''与命名参数协同工作''': 默认参数常与[[命名参数]]结合使用，增强可读性。

== 详细示例 ==
=== 多参数函数 ===
<syntaxhighlight lang="kotlin">
fun createUser(
    username: String,
    isAdmin: Boolean = false,
    email: String = "user@example.com"
) {
    println("User created: $username | Admin: $isAdmin | Email: $email")
}
</syntaxhighlight>

'''调用方式及输出'''：
{| class="wikitable"
! 调用代码 !! 输出结果
|-
| <code>createUser("Alice")</code> || <code>User created: Alice | Admin: false | Email: user@example.com</code>
|-
| <code>createUser("Bob", true)</code> || <code>User created: Bob | Admin: true | Email: user@example.com</code>
|-
| <code>createUser("Charlie", email = "charlie@kotlin.org")</code> || <code>User created: Charlie | Admin: false | Email: charlie@kotlin.org</code>
|}

=== 与命名参数结合 ===
当跳过某些默认参数时，需使用命名参数指定后续参数：
<syntaxhighlight lang="kotlin">
fun connect(
    host: String = "localhost",
    port: Int = 8080,
    timeout: Int = 5000
) { /* ... */ }

// 只设置timeout，跳过前两个参数
connect(timeout = 3000)
</syntaxhighlight>

== 实际应用场景 ==
=== 配置对象简化 ===
替代Builder模式或复杂构造函数：
<syntaxhighlight lang="kotlin">
class DatabaseConfig(
    val url: String = "jdbc:mysql://localhost:3306",
    val user: String = "root",
    val password: String = ""
)

// 使用默认配置
val defaultConfig = DatabaseConfig()
// 自定义部分参数
val customConfig = DatabaseConfig(password = "secure123")
</syntaxhighlight>

=== Android开发示例 ===
在Android视图扩展函数中常见：
<syntaxhighlight lang="kotlin">
fun View.showToast(
    message: String,
    duration: Int = Toast.LENGTH_SHORT
) {
    Toast.makeText(context, message, duration).show()
}

// 调用时通常只需message参数
showToast("Operation completed!")
</syntaxhighlight>

== 注意事项 ==
=== Java互操作性 ===
从Java调用Kotlin默认参数函数时，必须显式传递所有参数。可通过<code>@JvmOverloads</code>注解生成重载方法：
<syntaxhighlight lang="kotlin">
@JvmOverloads
fun calculate(a: Int, b: Int = 1, c: Int = 2) = a * b + c
</syntaxhighlight>

=== 参数顺序规则 ===
1. 默认参数后的所有参数必须也有默认值或为可变参数。
2. 错误示例：
<syntaxhighlight lang="kotlin">
// 编译错误：非默认参数不能在默认参数后
fun invalid(a: Int = 1, b: Int) { /* ... */ }
</syntaxhighlight>

== 高级用法 ==
=== 默认参数表达式 ===
默认值可以是运行时表达式：
<syntaxhighlight lang="kotlin">
fun generateId(prefix: String = "user", timestamp: Long = System.currentTimeMillis()) {
    return "$prefix-$timestamp"
}
</syntaxhighlight>

=== 函数类型参数 ===
Lambda参数也可有默认值：
<syntaxhighlight lang="kotlin">
fun runWithRetry(
    action: () -> Unit,
    retries: Int = 3,
    onError: (Exception) -> Unit = { e -> println("Error: ${e.message}") }
) { /* ... */ }
</syntaxhighlight>

== 可视化逻辑 ==
<mermaid>
graph TD
    A[函数调用] --> B{提供参数?}
    B -->|是| C[使用传入值]
    B -->|否| D[使用默认值]
    D --> E[执行函数体]
    C --> E
</mermaid>

== 数学表示 ==
对于函数<math>f(x_1, x_2, ..., x_n)</math>，其中<math>x_k</math>到<math>x_n</math>有默认值，调用时可省略：
<math>
f(a_1, a_2, ..., a_{k-1}) \equiv f(a_1, a_2, ..., a_{k-1}, d_k, ..., d_n)
</math>
其中<math>d_i</math>为默认值。

== 总结 ==
Kotlin的默认参数机制通过以下方式提升代码质量：
* '''减少样板代码'''：消除不必要的重载
* '''增强可读性'''：命名参数与默认值结合使意图更明确
* '''提高灵活性'''：允许渐进式提供复杂函数的参数

建议在以下场景优先使用：
* 具有明显常用默认值的参数
* 配置类函数的多个可选参数
* 需要向后兼容的API扩展

[[Category:编程语言]]
[[Category:Kotlin]]
[[Category:Kotlin函数]]