如何用kotlin做单元测试

在 Kotlin 中进行单元测试通常使用 JUnit（JUnit 4 或 JUnit 5）配合 Kotlin 测试库。下面是一步一步的介绍，从环境配置到常见写法。

一、添加依赖（以 Gradle 为例）

1️⃣ 使用 JUnit 4（最常见、简单）

dependencies {
    testImplementation("junit:junit:4.13.2")
}

2️⃣ 使用 JUnit 5（推荐新项目）

dependencies {
    testImplementation("org.junit.jupiter:junit-jupiter:5.10.0")
}

test {
    useJUnitPlatform()
}

3️⃣ Kotlin 官方测试增强（可选）

testImplementation("org.jetbrains.kotlin:kotlin-test")
testImplementation("org.jetbrains.kotlin:kotlin-test-junit5")

二、创建测试目录

标准结构：

src
 ├── main
 │   └── kotlin
 │       └── Calculator.kt
 └── test
     └── kotlin
         └── CalculatorTest.kt

三、示例：测试一个 Kotlin 类

1️⃣ 被测试类

class Calculator {
    fun add(a: Int, b: Int): Int = a + b
}

2️⃣ JUnit 4 单元测试

import org.junit.Test
import org.junit.Assert.*

class CalculatorTest {

    private val calculator = Calculator()

    @Test
    fun testAdd() {
        val result = calculator.add(2, 3)
        assertEquals(5, result)
    }
}

四、JUnit 5 写法（推荐）

import org.junit.jupiter.api.Test
import org.junit.jupiter.api.Assertions.*

class CalculatorTest {

    private val calculator = Calculator()

    @Test
    fun `add should return correct sum`() {
        val result = calculator.add(2, 3)
        assertEquals(5, result)
    }
}

✅ Kotlin 支持 反引号函数名，测试可读性更好

五、常用断言

assertEquals(expected, actual)
assertTrue(condition)
assertFalse(condition)
assertNull(value)
assertNotNull(value)
assertThrows<Exception> { ... }

六、Before / After 注解

JUnit 5

import org.junit.jupiter.api.*

class ExampleTest {

    @BeforeEach
    fun setup() {
        println("测试前执行")
    }

    @AfterEach
    fun teardown() {
        println("测试后执行")
    }

    @Test
    fun testSomething() { }
}

七、Mock 测试（常用）

使用 MockK（Kotlin 专用）

testImplementation("io.mockk:mockk:1.13.9")

import io.mockk.every
import io.mockk.mockk
import io.mockk.verify

class UserServiceTest {

    private val userRepository = mockk<UserRepository>()
    private val userService = UserService(userRepository)

    @Test
    fun `should return user name`() {
        every { userRepository.getName(1) } returns "Alice"

        val name = userService.getUserName(1)

        assertEquals("Alice", name)
        verify { userRepository.getName(1) }
    }
}

八、运行测试

Gradle

./gradlew test

IDE

• IntelliJ IDEA：右键测试类 → Run

九、最佳实践建议

✅ 一个测试只验证一个行为
✅ 使用清晰的方法名（推荐反引号）
✅ 不依赖测试执行顺序
✅ 外部依赖用 Mock
✅ 测试应快速、稳定、可重复

如果你有具体场景（如 Android、Coroutine、ViewModel、Spring Boot），我可以给你更针对性的示例。