Kotlin 2.1.0 的发布为开发者带来了一个期待已久的改进：when 语句的防护条件（guard conditions）。这一新特性通过允许在评估 when 语句中的情况时指定额外的条件（守卫），增强了代码的可读性和灵活性。

什么是guard condition（哨兵？守卫条件）？

守卫条件为 when 语句增加了一层额外的逻辑，在标准类型或值评估之外执行额外的检查。在此之前，可能需要使用额外的 when 语句或 if 表达式。现在，可以直接在单个 case 中定义复杂的条件。

示例：使用和不使用防护条件

为了说明守卫条件的好处，考虑使用密封类 HttpResult 的场景：

sealed interface HttpResult {
    data class Success(val response: String) : HttpResult
    data class Failed(val statusCode: Int) : HttpResult
}

使用守卫条件：

when (response) {
    is HttpResult.Success -> println("Success")
    is HttpResult.Failed if response.statusCode == 503 -> println("Maintenance")
    is HttpResult.Failed -> println("Failed with code ${response.statusCode}")
}

在这里，处理特定状态码（503）的 HttpResult.Failed 的逻辑被无缝集成到 when 语句中，使代码保持简洁和可读。

不使用守卫条件：

在守卫条件之前，需要这样编写逻辑：

when (response) {
    is HttpResult.Success -> println("Success")
    is HttpResult.Failed -> {
        if (response.statusCode == 503) {
            println("Maintenance")
        } else {
            println("Failed with code ${response.statusCode}")
        }
    }
}

这种方法需要在 when 块内嵌套一个 if 语句，使代码不那么简洁且更难阅读。

重要提示：when 仍然必须是详尽的

尽管守卫条件提供了额外的灵活性，when 语句的一个重要属性仍然保持不变：详尽性。编译器仍然要求您在 when 语句中覆盖所有可能的情况，特别是在处理密封类时。

例如，以下代码将导致编译错误，因为未处理 HttpResult 的所有情况：

when (response) {
    is HttpResult.Success -> println("Success")
    is HttpResult.Failed if response.statusCode == 503 -> println("Maintenance")
}

要修复这个问题，必须添加处理 HttpResult.Failed 所有其他实例的情况。

如何启用？

这个特性处于预览状态，需要明确启用。按照以下步骤操作：

1. 在 IntelliJ IDEA/Android Studio 中启用 K2 编译器

要使用守卫条件，需要在 IntelliJ IDEA 或 Android Studio 中激活 K2 编译器：

• 转到 Settings | Languages & Frameworks | Kotlin
• 勾选 Enable K2 mode（需要重启 IDE）

2. 在 build.gradle.kts 中添加编译器选项

在 build.gradle.kts 中添加以下配置以启用守卫条件：

kotlin {
    compilerOptions {
        freeCompilerArgs.add("-Xwhen-guards")
    }
}

使用场景

守卫条件在以下场景特别有用：

• ? 处理复杂的 when 语句和特定检查时
• ? 使用密封类或枚举优雅地处理多态时
• ? 在评估各种值和状态组合时希望保持逻辑清晰简洁

总结

Kotlin 2.1.0 中引入的守卫条件是一个小但强大的改进，它简化了编写清晰和可维护代码的过程。但请记住，when 语句仍然必须是详尽的，这确保了逻辑在增加灵活性的同时保持健壮。