Scala 函数 – 默认参数值（建议收藏）

Scala 函数 – 默认参数值：让函数更灵活、更优雅

在学习 Scala 的过程中，你可能会发现，函数的定义方式和你之前接触的 Java 或 Python 有些不同。尤其是当函数参数越来越多时，调用起来会变得特别繁琐。比如，一个配置函数需要传入十几个参数，但其中只有几个是必须的，其余都是可选的。这时候，如果能给参数设置默认值，是不是就方便多了？

这就是 Scala 提供的“默认参数值”功能的魅力所在。它不仅能减少重复代码，还能让函数调用更加直观和灵活。今天我们就来深入聊聊这个实用又容易被忽视的特性。

什么是默认参数值？

默认参数值（Default Parameters）是函数定义中为某些参数指定默认值的机制。当调用函数时，如果未提供对应参数的值，Scala 会自动使用定义时设定的默认值。

你可以把默认参数值想象成“备胎”——你不需要每次都手动指定，但一旦需要，它随时可以顶上。比如你在写一个发送邮件的函数，大多数情况下收件人、主题和内容是固定的，只有附件是偶尔才添加的，那就可以把附件设为默认值 None。

def sendEmail(to: String, subject: String, body: String, attachment: Option[String] = None): Unit = {
  println(s"发送邮件给: $to")
  println(s"主题: $subject")
  println(s"内容: $body")
  attachment match {
    case Some(file) => println(s"附带文件: $file")
    case None       => println("无附件")
  }
}

说明：

attachment: Option[String] = None 表示 attachment 参数的默认值是 None。

Option[String] 是 Scala 中表示“可能有值，也可能没有”的类型，相当于 Java 的 Optional<String>。

如果调用时不传 attachment，函数会自动使用 None。

默认参数值的语法与位置规则

Scala 中，默认参数值的语法非常简单：在参数类型后使用 = 值 的形式即可。但注意一个关键规则：默认参数必须放在所有非默认参数之后。

这就像排队买票，前面的人必须先买票，后面的人可以“插队”——但你不能让后面的人先买，前面的人等。

// ✅ 正确写法：默认参数在最后
def greet(name: String, greeting: String = "Hello", times: Int = 1): Unit = {
  for (_ <- 1 to times) println(s"$greeting, $name!")
}

// ❌ 错误写法：默认参数在前面
// def greet(greeting: String = "Hello", name: String, times: Int = 1) = ... 
// 编译会报错：非默认参数不能出现在默认参数之后

为什么这样设计？
因为 Scala 在调用函数时，参数是按位置传递的。如果默认参数不在最后，编译器就无法判断你到底传了哪些参数。例如 greet("Alice")，它到底是给 greeting 传了 "Alice"，还是给 name 传了 "Alice"？歧义就来了。

实际应用场景：配置函数的优雅实现

假设你要写一个数据库连接配置函数，它需要 host、port、username、password、timeout、maxConnections 等参数。其中，host 和 username 是必须的，其余都可以有合理默认值。

def connectToDatabase(
  host: String,
  port: Int = 5432,
  username: String,
  password: String = "secret",
  timeout: Int = 30,
  maxConnections: Int = 10
): Unit = {
  println(s"连接到数据库: $host:$port")
  println(s"用户名: $username")
  println(s"密码: $password (已隐藏)")
  println(s"超时时间: $timeout 秒")
  println(s"最大连接数: $maxConnections")
}

现在，你可以这样调用：

// 最简调用：只传必须参数
connectToDatabase("localhost", "admin")

// 传部分可选参数：指定 host 和 username，其他用默认值
connectToDatabase("192.168.1.100", "app_user")

// 指定特定的 port 和 timeout
connectToDatabase("prod-db.example.com", "dbuser", port = 3306, timeout = 60)

重点提示：

port = 3306 这种写法叫“命名参数”（Named Arguments），允许你跳过中间参数直接指定后面的。

它在默认参数值配合使用时尤其有用，能大幅提升代码可读性。

默认参数值与函数重载的对比

在某些语言中，你可能会用函数重载（Overloading）来实现“可选参数”的效果。比如 Java 中定义多个同名但参数不同的方法。

但在 Scala 中，默认参数值是更优的选择。原因如下：

减少冗余代码：不需要写多个函数签名。
更灵活：可以任意组合参数，而不必为每种组合都写一个函数。
更易维护：修改默认值只需改一处。

来看一个对比：

Java 方式（函数重载）：

public void sendEmail(String to, String subject) {
  sendEmail(to, subject, "", false);
}

public void sendEmail(String to, String subject, String body) {
  sendEmail(to, subject, body, false);
}

public void sendEmail(String to, String subject, String body, boolean urgent) {
  // 实现
}

Scala 方式（默认参数值）：

def sendEmail(
  to: String,
  subject: String,
  body: String = "",
  urgent: Boolean = false
): Unit = {
  println(s"发送邮件给: $to, 主题: $subject, 内容: $body, 紧急: $urgent")
}

结论：Scala 的默认参数值更简洁、更清晰，避免了函数重载带来的复杂性和维护成本。

默认参数值的底层机制：编译器如何处理？

当你定义一个带有默认参数值的函数时，Scala 编译器会做两件事：

生成多个“备选”函数签名，每个签名对应不同的参数组合。
在调用时，根据你传入的参数自动选择最匹配的版本。

这其实是一种“语法糖”——你写的是一条函数定义，但编译后相当于多个函数。

比如这个函数：

def formatText(text: String, align: String = "left", size: Int = 12): String = {
  s"文本: $text, 对齐: $align, 大小: $size"
}

编译器会生成类似这样的“隐藏函数”：

formatText(text: String, align: String, size: Int)
formatText(text: String, align: String)
formatText(text: String)

当你调用 formatText("Hello")，编译器自动匹配第三个版本。

这解释了为什么命名参数（如 align = "center"）能跳过中间参数——因为底层有多个函数可供选择。

最佳实践与注意事项

虽然默认参数值非常方便，但使用时仍需注意几点：

1. 避免使用可变对象作为默认值

// ❌ 危险！
def addLog(messages: List[String] = List()): Unit = {
  messages += "New log"
  println(messages)
}

问题在于：List() 是每次调用都新建的，但如果是 ListBuffer 或 ArrayBuffer，则可能共享同一个实例，导致副作用。

✅ 正确做法是使用 List.empty[String] 或 Nil，确保每次都是新对象。

2. 默认值应为“安全的”或“合理的”

比如 timeout = 30 是合理的，但 timeout = -1 就不合适，容易引发逻辑错误。

3. 文档化默认值

在函数注释中说明默认值的含义，有助于他人理解使用方式。

/**
 * 发送邮件
 * @param to 收件人邮箱
 * @param subject 主题，缺省为 "New Message"
 * @param body 正文内容，缺省为空
 * @param urgent 是否紧急，缺省为 false
 */
def sendEmail(to: String, subject: String = "New Message", body: String = "", urgent: Boolean = false): Unit = {
  // 实现
}

总结：让函数更智能、更简洁

Scala 函数 – 默认参数值，是提升代码可读性和灵活性的重要工具。它让你的函数不再“千篇一律”，而是能根据调用上下文自动“适应”。

它让函数调用更简洁，减少冗余参数。
它支持命名参数，提升代码可读性。
它避免了函数重载的复杂性。
它是构建 DSL（领域特定语言）时的利器。

无论你是写工具函数、配置接口，还是构建微服务，掌握这个特性都能让你的代码更优雅、更专业。

记住：好的函数，不在于参数多，而在于“用得少，想得全”。而 Scala 的默认参数值，正是帮助你实现这一点的关键一招。