Kotlin Academy · 课时

runCatching

Q: 「runCatching」这节课中我会学到什么？

将异常捕获为值 你通过在浏览器中直接运行的动手代码来练习 Kotlin Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

将异常捕获为值

runCatching 是 CoddyKit 上的免费 Kotlin Academy 课时。这是第 2 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Kotlin Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Kotlin Academy 课程共包含 4 节课。

捕获异常

runCatching 运行一个代码块，并将其结果包装到 Result 中：返回值变成 success，任何抛出的异常都变成 failure。不需要使用 try/catch。

基本用法

传入一个匿名函数；最后一个表达式就是 success 值。

fun main() {
    val r = runCatching { 10 / 2 }
    println(r.isSuccess)
    println(r.getOrNull())
}

捕获抛出的错误

当代码块抛出异常时，runCatching 会存储该异常，而不是继续传播它。

fun main() {
    val r = runCatching { 10 / 0 }
    println(r.isFailure)
    println(r.exceptionOrNull()?.message)
}

包装有风险的解析

一种常见用法是包装可能抛出异常的 calls，例如解析操作，这样 failure 就会变成可以处理的值。

fun main() {
    val good = runCatching { "42".toInt() }
    val bad = runCatching { "abc".toInt() }
    println(good.getOrNull())
    println(bad.getOrNull())
}

作为接收者使用 runCatching

您可以在接收对象上调用 runCatching；在代码块内，this 指向该对象。这对于在一个值上链接多个操作很有用。

fun main() {
    val text = "  99 "
    val r = text.runCatching { trim().toInt() }
    println(r.getOrNull())
}

内联恢复

将它与 getOrElse 结合，可以直接在 call site 提供备用值。

fun main() {
    val n = runCatching { "oops".toInt() }.getOrElse { -1 }
    println(n)
}

使用 fold 处理两个分支

fold 可以在一次调用中处理 success 和 failure，并从任一分支返回一个统一的值。

fun main() {
    val message = runCatching { "50".toInt() }.fold(
        onSuccess = { "got " + it },
        onFailure = { "error: " + it.message }
    )
    println(message)
}

重构异常捕获

如果您原本会编写 try/catch 来返回一个值，runCatching 会更加简洁，并且能将结果保持为数据。

fun safeDivide(a: Int, b: Int): Result<Int> =
    runCatching { a / b }

fun main() {
    println(safeDivide(8, 2).getOrNull())
    println(safeDivide(8, 0).exceptionOrNull()?.message)
}

谨慎使用宽泛捕获

runCatching 会捕获所有可抛出对象，包括您可能不希望吞掉的对象。请避免包装过大的代码块；让捕获范围保持小而明确。

链接转换

由于 runCatching 会产生一个 Result，因此您可以立即在其上链接 map 或 recover。我们将在下一课探讨这些内容。

fun main() {
    val r = runCatching { "7".toInt() }.map { it * 10 }
    println(r.getOrNull())
}

它为何有帮助

runCatching 在抛出异常的代码与基于值的 Result 世界之间建立了桥梁。即使调用会抛出异常的应用程序接口，它也能让您采用函数式错误处理。

快速检查

请测试您对 runCatching 的理解。

回顾

您学习了 runCatching：

将代码块的结果包装到 Result 中
将抛出的异常转换为 failure
与 getOrElse 和 fold 结合使用
让捕获范围保持小

下一步：构建密封的结果层次结构。

常见问题解答

「runCatching」课时是免费的吗？

是的 — 「runCatching」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Kotlin Academy 课程的其余内容，请升级到 CoddyKit PRO。 Kotlin Academy 课程共包含 4 节课。

「runCatching」这节课中我会学到什么？

将异常捕获为值你通过在浏览器中直接运行的动手代码来练习 Kotlin Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Kotlin Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Kotlin Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 2 节课，共 4 节。

「runCatching」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Kotlin Academy 课中编写并运行代码吗？

能。每节 Kotlin Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Kotlin Academy