Kotlin Academy · 课时

断言

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

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

验证行为

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

什么是断言？

断言会检查实际值是否符合您的预期。如果断言失败，测试也会失败，并显示有帮助的消息。

JUnit5 在 org.junit.jupiter.api.Assertions 中提供了断言。

assertEquals

最常用的断言。请注意顺序：预期值在前，实际值在后。

import org.junit.jupiter.api.Assertions.assertEquals

fun main() {
    val sum = 2 + 3
    assertEquals(5, sum)
    println("passed")
}

assertTrue 和 assertFalse

直接对布尔条件进行断言。

import org.junit.jupiter.api.Assertions.assertTrue
import org.junit.jupiter.api.Assertions.assertFalse

fun main() {
    assertTrue(10 > 5)
    assertFalse("".isNotEmpty())
    println("ok")
}

空值断言

使用 assertNull 和 assertNotNull 验证可空性。在许多情况下，assertNotNull 还会执行智能类型转换。

import org.junit.jupiter.api.Assertions.assertNotNull
import org.junit.jupiter.api.Assertions.assertNull

fun main() {
    val name: String? = "Ada"
    assertNotNull(name)
    assertNull(null)
    println("done")
}

断言异常

assertThrows 会验证某个代码块是否抛出指定的异常。它会返回该异常，因此您可以检查其中的消息。

import org.junit.jupiter.api.Assertions.assertThrows
import org.junit.jupiter.api.Assertions.assertEquals

fun main() {
    val ex = assertThrows(IllegalArgumentException::class.java) {
        require(false) { "bad input" }
    }
    assertEquals("bad input", ex.message)
    println("caught")
}

分组断言

assertAll 会运行多个断言，并将所有失败一起报告，而不是在第一个失败处停止。

import org.junit.jupiter.api.Assertions.assertAll
import org.junit.jupiter.api.Assertions.assertEquals

fun main() {
    assertAll(
        { assertEquals(2, 1 + 1) },
        { assertEquals(4, 2 + 2) }
    )
    println("all passed")
}

失败消息

传入消息（或惰性消息 lambda），可以让失败原因一目了然。

import org.junit.jupiter.api.Assertions.assertEquals

fun main() {
    val balance = 100
    assertEquals(100, balance, "balance should be unchanged")
    println("ok")
}

比较集合

当列表的顺序和内容都匹配时，assertEquals 可以用于列表。对于具体类型不同的可迭代对象，请使用 assertIterableEquals。

import org.junit.jupiter.api.Assertions.assertEquals

fun main() {
    val expected = listOf(1, 2, 3)
    val actual = (1..3).toList()
    assertEquals(expected, actual)
    println("lists equal")
}

使用 AssertK 进行流式断言

AssertK 等库提供了易读的 assertThat(x).isEqualTo(y) 风格，这种风格在 Kotlin 代码库中很受欢迎。

// assertThat(result).isEqualTo(5)
// assertThat(list).contains("a", "b")
// assertThat(name).isNotNull()

强制失败

调用 fail 强制测试失败，这对于标记不应到达的分支或尚未完成的测试很有用。

import org.junit.jupiter.api.Assertions.fail

fun process(x: Int): String = when {
    x > 0 -> "positive"
    else -> fail("unexpected value")
}

选择正确的断言

选择最具体的断言，以便获得清晰的失败信息：

相等性 → assertEquals
条件 → assertTrue/assertFalse
错误 → assertThrows
多项检查 → assertAll

快速检查

您希望测试一次报告所有失败的检查，而不是在第一个失败处停止。应该使用什么？

回顾

现在您已经了解 JUnit5 断言：

assertEquals（预期值在前）、assertTrue/assertFalse
assertNull/assertNotNull、assertThrows
使用 assertAll 进行分组检查
添加消息以提高清晰度

下一节：使用 MockK 模拟依赖项。

常见问题解答

「断言」课时是免费的吗？

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

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

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

学习 Kotlin Academy 需要有经验吗？

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

「断言」课时需要多长时间？

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

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

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

此课程中的所有课时

← 返回 Kotlin Academy