[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M72Y4RMYKVZ2XF2EPCQSQYWG":3,"skill-same:01M72Y4RMYKVZ2XF2EPCQSQYWG":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M72Y4RMYKVZ2XF2EPCQSQYWG","kotlin-testing",null,"使用Kotest、MockK、协程测试、基于属性的测试和Kover覆盖率的Kotlin测试模式。遵循TDD方法论和地道的Kotlin实践。","SriramGandhiS\u002FSkills","SriramGandhiS","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F211849986?v=4","01M72WQCW12BYX71C6WN584TTA","Sriram S","01M72WQCWTJ2RD0ET1X31AF1RC",1,"MIT","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Feverything-claude-code\u002Fdocs\u002Fzh-CN\u002Fskills\u002Fkotlin-testing\u002FSKILL.md",[],[],"2026-11-10 22:39:42",false,"---\nname: kotlin-testing\ndescription: 使用Kotest、MockK、协程测试、基于属性的测试和Kover覆盖率的Kotlin测试模式。遵循TDD方法论和地道的Kotlin实践。\norigin: ECC\n---\n\n# Kotlin 测试模式\n\n遵循 TDD 方法论，使用 Kotest 和 MockK 编写可靠、可维护测试的全面 Kotlin 测试模式。\n\n## 何时使用\n\n* 编写新的 Kotlin 函数或类\n* 为现有 Kotlin 代码添加测试覆盖率\n* 实现基于属性的测试\n* 在 Kotlin 项目中遵循 TDD 工作流\n* 为代码覆盖率配置 Kover\n\n## 工作原理\n\n1. **确定目标代码** — 找到要测试的函数、类或模块\n2. **编写 Kotest 规范** — 选择与测试范围匹配的规范样式（StringSpec、FunSpec、BehaviorSpec）\n3. **模拟依赖项** — 使用 MockK 来隔离被测单元\n4. **运行测试（红色阶段）** — 验证测试是否按预期失败\n5. **实现代码（绿色阶段）** — 编写最少的代码以使测试通过\n6. **重构** — 改进实现，同时保持测试通过\n7. **检查覆盖率** — 运行 `.\u002Fgradlew koverHtmlReport` 并验证 80%+ 的覆盖率\n\n## 示例\n\n以下部分包含每个测试模式的详细、可运行示例：\n\n### 快速参考\n\n* **Kotest 规范** — [Kotest 规范样式](#kotest-规范样式) 中的 StringSpec、FunSpec、BehaviorSpec、DescribeSpec 示例\n* **模拟** — [MockK](#mockk) 中的 MockK 设置、协程模拟、参数捕获\n* **TDD 演练** — [Kotlin 的 TDD 工作流](#kotlin-的-tdd-工作流) 中 EmailValidator 的完整 RED\u002FGREEN\u002FREFACTOR 周期\n* **覆盖率** — [Kover 覆盖率](#kover-覆盖率) 中的 Kover 配置和命令\n* **Ktor 测试** — [Ktor testApplication 测试](#ktor-testapplication-测试) 中的 testApplication 设置\n\n### Kotlin 的 TDD 工作流\n\n#### RED-GREEN-REFACTOR 周期\n\n```\nRED     -> 首先编写一个失败的测试\nGREEN   -> 编写最少的代码使测试通过\nREFACTOR -> 改进代码同时保持测试通过\nREPEAT  -> 继续下一个需求\n```\n\n#### Kotlin 中逐步进行 TDD\n\n```kotlin\n\u002F\u002F Step 1: Define the interface\u002Fsignature\n\u002F\u002F EmailValidator.kt\npackage com.example.validator\n\nfun validateEmail(email: String): Result\u003CString> {\n    TODO(\"not implemented\")\n}\n\n\u002F\u002F Step 2: Write failing test (RED)\n\u002F\u002F EmailValidatorTest.kt\npackage com.example.validator\n\nimport io.kotest.core.spec.style.StringSpec\nimport io.kotest.matchers.result.shouldBeFailure\nimport io.kotest.matchers.result.shouldBeSuccess\n\nclass EmailValidatorTest : StringSpec({\n    \"valid email returns success\" {\n        validateEmail(\"user@example.com\").shouldBeSuccess(\"user@example.com\")\n    }\n\n    \"empty email returns failure\" {\n        validateEmail(\"\").shouldBeFailure()\n    }\n\n    \"email without @ returns failure\" {\n        validateEmail(\"userexample.com\").shouldBeFailure()\n    }\n})\n\n\u002F\u002F Step 3: Run tests - verify FAIL\n\u002F\u002F $ .\u002Fgradlew test\n\u002F\u002F EmailValidatorTest > valid email returns success FAILED\n\u002F\u002F   kotlin.NotImplementedError: An operation is not implemented\n\n\u002F\u002F Step 4: Implement minimal code (GREEN)\nfun validateEmail(email: String): Result\u003CString> {\n    if (email.isBlank()) return Result.failure(IllegalArgumentException(\"Email cannot be blank\"))\n    if ('@' !in email) return Result.failure(IllegalArgumentException(\"Email must contain @\"))\n    val regex = Regex(\"^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\\\.[A-Za-z]{2,}$\")\n    if (!regex.matches(email)) return Result.failure(IllegalArgumentException(\"Invalid email format\"))\n    return Result.success(email)\n}\n\n\u002F\u002F Step 5: Run tests - verify PASS\n\u002F\u002F $ .\u002Fgradlew test\n\u002F\u002F EmailValidatorTest > valid email returns success PASSED\n\u002F\u002F EmailValidatorTest > empty email returns failure PASSED\n\u002F\u002F EmailValidatorTest > email without @ returns failure PASSED\n\n\u002F\u002F Step 6: Refactor if needed, verify tests still pass\n```\n\n### Kotest 规范样式\n\n#### StringSpec（最简单）\n\n```kotlin\nclass CalculatorTest : StringSpec({\n    \"add two positive numbers\" {\n        Calculator.add(2, 3) shouldBe 5\n    }\n\n    \"add negative numbers\" {\n        Calculator.add(-1, -2) shouldBe -3\n    }\n\n    \"add zero\" {\n        Calculator.add(0, 5) shouldBe 5\n    }\n})\n```\n\n#### FunSpec（类似 JUnit）\n\n```kotlin\nclass UserServiceTest : FunSpec({\n    val repository = mockk\u003CUserRepository>()\n    val service = UserService(repository)\n\n    test(\"getUser returns user when found\") {\n        val expected = User(id = \"1\", name = \"Alice\")\n        coEvery { repository.findById(\"1\") } returns expected\n\n        val result = service.getUser(\"1\")\n\n        result shouldBe expected\n    }\n\n    test(\"getUser throws when not found\") {\n        coEvery { repository.findById(\"999\") } returns null\n\n        shouldThrow\u003CUserNotFoundException> {\n            service.getUser(\"999\")\n        }\n    }\n})\n```\n\n#### BehaviorSpec（BDD 风格）\n\n```kotlin\nclass OrderServiceTest : BehaviorSpec({\n    val repository = mockk\u003COrderRepository>()\n    val paymentService = mockk\u003CPaymentService>()\n    val service = OrderService(repository, paymentService)\n\n    Given(\"a valid order request\") {\n        val request = CreateOrderRequest(\n            userId = \"user-1\",\n            items = listOf(OrderItem(\"product-1\", quantity = 2)),\n        )\n\n        When(\"the order is placed\") {\n            coEvery { paymentService.charge(any()) } returns PaymentResult.Success\n            coEvery { repository.save(any()) } answers { firstArg() }\n\n            val result = service.placeOrder(request)\n\n            Then(\"it should return a confirmed order\") {\n                result.status shouldBe OrderStatus.CONFIRMED\n            }\n\n            Then(\"it should charge payment\") {\n                coVerify(exactly = 1) { paymentService.charge(any()) }\n            }\n        }\n\n        When(\"payment fails\") {\n            coEvery { paymentService.charge(any()) } returns PaymentResult.Declined\n\n            Then(\"it should throw PaymentException\") {\n                shouldThrow\u003CPaymentException> {\n                    service.placeOrder(request)\n                }\n            }\n        }\n    }\n})\n```\n\n#### DescribeSpec（RSpec 风格）\n\n```kotlin\nclass UserValidatorTest : DescribeSpec({\n    describe(\"validateUser\") {\n        val validator = UserValidator()\n\n        context(\"with valid input\") {\n            it(\"accepts a normal user\") {\n                val user = CreateUserRequest(\"Alice\", \"alice@example.com\")\n                validator.validate(user).shouldBeValid()\n            }\n        }\n\n        context(\"with invalid name\") {\n            it(\"rejects blank name\") {\n                val user = CreateUserRequest(\"\", \"alice@example.com\")\n                validator.validate(user).shouldBeInvalid()\n            }\n\n            it(\"rejects name exceeding max length\") {\n                val user = CreateUserRequest(\"A\".repeat(256), \"alice@example.com\")\n                validator.validate(user).shouldBeInvalid()\n            }\n        }\n    }\n})\n```\n\n### Kotest 匹配器\n\n#### 核心匹配器\n\n```kotlin\nimport io.kotest.matchers.shouldBe\nimport io.kotest.matchers.shouldNotBe\nimport io.kotest.matchers.string.*\nimport io.kotest.matchers.collections.*\nimport io.kotest.matchers.nulls.*\n\n\u002F\u002F Equality\nresult shouldBe expected\nresult shouldNotBe unexpected\n\n\u002F\u002F Strings\nname shouldStartWith \"Al\"\nname shouldEndWith \"ice\"\nname shouldContain \"lic\"\nname shouldMatch Regex(\"[A-Z][a-z]+\")\nname.shouldBeBlank()\n\n\u002F\u002F Collections\nlist shouldContain \"item\"\nlist shouldHaveSize 3\nlist.shouldBeSorted()\nlist.shouldContainAll(\"a\", \"b\", \"c\")\nlist.shouldBeEmpty()\n\n\u002F\u002F Nulls\nresult.shouldNotBeNull()\nresult.shouldBeNull()\n\n\u002F\u002F Types\nresult.shouldBeInstanceOf\u003CUser>()\n\n\u002F\u002F Numbers\ncount shouldBeGreaterThan 0\nprice shouldBeInRange 1.0..100.0\n\n\u002F\u002F Exceptions\nshouldThrow\u003CIllegalArgumentException> {\n    validateAge(-1)\n}.message shouldBe \"Age must be positive\"\n\nshouldNotThrow\u003CException> {\n    validateAge(25)\n}\n```\n\n#### 自定义匹配器\n\n```kotlin\nfun beActiveUser() = object : Matcher\u003CUser> {\n    override fun test(value: User) = MatcherResult(\n        value.isActive && value.lastLogin != null,\n        { \"User ${value.id} should be active with a last login\" },\n        { \"User ${value.id} should not be active\" },\n    )\n}\n\n\u002F\u002F Usage\nuser should beActiveUser()\n```\n\n### MockK\n\n#### 基本模拟\n\n```kotlin\nclass UserServiceTest : FunSpec({\n    val repository = mockk\u003CUserRepository>()\n    val logger = mockk\u003CLogger>(relaxed = true) \u002F\u002F Relaxed: returns defaults\n    val service = UserService(repository, logger)\n\n    beforeTest {\n        clearMocks(repository, logger)\n    }\n\n    test(\"findUser delegates to repository\") {\n        val expected = User(id = \"1\", name = \"Alice\")\n        every { repository.findById(\"1\") } returns expected\n\n        val result = service.findUser(\"1\")\n\n        result shouldBe expected\n        verify(exactly = 1) { repository.findById(\"1\") }\n    }\n\n    test(\"findUser returns null for unknown id\") {\n        every { repository.findById(any()) } returns null\n\n        val result = service.findUser(\"unknown\")\n\n        result.shouldBeNull()\n    }\n})\n```\n\n#### 协程模拟\n\n```kotlin\nclass AsyncUserServiceTest : FunSpec({\n    val repository = mockk\u003CUserRepository>()\n    val service = UserService(repository)\n\n    test(\"getUser suspending function\") {\n        coEvery { repository.findById(\"1\") } returns User(id = \"1\", name = \"Alice\")\n\n        val result = service.getUser(\"1\")\n\n        result.name shouldBe \"Alice\"\n        coVerify { repository.findById(\"1\") }\n    }\n\n    test(\"getUser with delay\") {\n        coEvery { repository.findById(\"1\") } coAnswers {\n            delay(100) \u002F\u002F Simulate async work\n            User(id = \"1\", name = \"Alice\")\n        }\n\n        val result = service.getUser(\"1\")\n        result.name shouldBe \"Alice\"\n    }\n})\n```\n\n#### 参数捕获\n\n```kotlin\ntest(\"save captures the user argument\") {\n    val slot = slot\u003CUser>()\n    coEvery { repository.save(capture(slot)) } returns Unit\n\n    service.createUser(CreateUserRequest(\"Alice\", \"alice@example.com\"))\n\n    slot.captured.name shouldBe \"Alice\"\n    slot.captured.email shouldBe \"alice@example.com\"\n    slot.captured.id.shouldNotBeNull()\n}\n```\n\n#### 间谍和部分模拟\n\n```kotlin\ntest(\"spy on real object\") {\n    val realService = UserService(repository)\n    val spy = spyk(realService)\n\n    every { spy.generateId() } returns \"fixed-id\"\n\n    spy.createUser(request)\n\n    verify { spy.generateId() } \u002F\u002F Overridden\n    \u002F\u002F Other methods use real implementation\n}\n```\n\n### 协程测试\n\n#### 用于挂起函数的 runTest\n\n```kotlin\nimport kotlinx.coroutines.test.runTest\n\nclass CoroutineServiceTest : FunSpec({\n    test(\"concurrent fetches complete together\") {\n        runTest {\n            val service = DataService(testScope = this)\n\n            val result = service.fetchAllData()\n\n            result.users.shouldNotBeEmpty()\n            result.products.shouldNotBeEmpty()\n        }\n    }\n\n    test(\"timeout after delay\") {\n        runTest {\n            val service = SlowService()\n\n            shouldThrow\u003CTimeoutCancellationException> {\n                withTimeout(100) {\n                    service.slowOperation() \u002F\u002F Takes > 100ms\n                }\n            }\n        }\n    }\n})\n```\n\n#### 测试 Flow\n\n```kotlin\nimport io.kotest.matchers.collections.shouldContainInOrder\nimport kotlinx.coroutines.flow.MutableSharedFlow\nimport kotlinx.coroutines.flow.toList\nimport kotlinx.coroutines.launch\nimport kotlinx.coroutines.test.advanceTimeBy\nimport kotlinx.coroutines.test.runTest\n\nclass FlowServiceTest : FunSpec({\n    test(\"observeUsers emits updates\") {\n        runTest {\n            val service = UserFlowService()\n\n            val emissions = service.observeUsers()\n                .take(3)\n                .toList()\n\n            emissions shouldHaveSize 3\n            emissions.last().shouldNotBeEmpty()\n        }\n    }\n\n    test(\"searchUsers debounces input\") {\n        runTest {\n            val service = SearchService()\n            val queries = MutableSharedFlow\u003CString>()\n\n            val results = mutableListOf\u003CList\u003CUser>>()\n            val job = launch {\n                service.searchUsers(queries).collect { results.add(it) }\n            }\n\n            queries.emit(\"a\")\n            queries.emit(\"ab\")\n            queries.emit(\"abc\") \u002F\u002F Only this should trigger search\n            advanceTimeBy(500)\n\n            results shouldHaveSize 1\n            job.cancel()\n        }\n    }\n})\n```\n\n#### TestDispatcher\n\n```kotlin\nimport kotlinx.coroutines.test.StandardTestDispatcher\nimport kotlinx.coroutines.test.advanceUntilIdle\n\nclass DispatcherTest : FunSpec({\n    test(\"uses test dispatcher for controlled execution\") {\n        val dispatcher = StandardTestDispatcher()\n\n        runTest(dispatcher) {\n            var completed = false\n\n            launch {\n                delay(1000)\n                completed = true\n            }\n\n            completed shouldBe false\n            advanceTimeBy(1000)\n            completed shouldBe true\n        }\n    }\n})\n```\n\n### 基于属性的测试\n\n#### Kotest 属性测试\n\n```kotlin\nimport io.kotest.core.spec.style.FunSpec\nimport io.kotest.property.Arb\nimport io.kotest.property.arbitrary.*\nimport io.kotest.property.forAll\nimport io.kotest.property.checkAll\nimport kotlinx.serialization.json.Json\nimport kotlinx.serialization.encodeToString\nimport kotlinx.serialization.decodeFromString\n\n\u002F\u002F Note: The serialization roundtrip test below requires the User data class\n\u002F\u002F to be annotated with @Serializable (from kotlinx.serialization).\n\nclass PropertyTest : FunSpec({\n    test(\"string reverse is involutory\") {\n        forAll\u003CString> { s ->\n            s.reversed().reversed() == s\n        }\n    }\n\n    test(\"list sort is idempotent\") {\n        forAll(Arb.list(Arb.int())) { list ->\n            list.sorted() == list.sorted().sorted()\n        }\n    }\n\n    test(\"serialization roundtrip preserves data\") {\n        checkAll(Arb.bind(Arb.string(1..50), Arb.string(5..100)) { name, email ->\n            User(name = name, email = \"$email@test.com\")\n        }) { user ->\n            val json = Json.encodeToString(user)\n            val decoded = Json.decodeFromString\u003CUser>(json)\n            decoded shouldBe user\n        }\n    }\n})\n```\n\n#### 自定义生成器\n\n```kotlin\nval userArb: Arb\u003CUser> = Arb.bind(\n    Arb.string(minSize = 1, maxSize = 50),\n    Arb.email(),\n    Arb.enum\u003CRole>(),\n) { name, email, role ->\n    User(\n        id = UserId(UUID.randomUUID().toString()),\n        name = name,\n        email = Email(email),\n        role = role,\n    )\n}\n\nval moneyArb: Arb\u003CMoney> = Arb.bind(\n    Arb.long(1L..1_000_000L),\n    Arb.enum\u003CCurrency>(),\n) { amount, currency ->\n    Money(amount, currency)\n}\n```\n\n### 数据驱动测试\n\n#### Kotest 中的 withData\n\n```kotlin\nclass ParserTest : FunSpec({\n    context(\"parsing valid dates\") {\n        withData(\n            \"2026-01-15\" to LocalDate(2026, 1, 15),\n            \"2026-12-31\" to LocalDate(2026, 12, 31),\n            \"2000-01-01\" to LocalDate(2000, 1, 1),\n        ) { (input, expected) ->\n            parseDate(input) shouldBe expected\n        }\n    }\n\n    context(\"rejecting invalid dates\") {\n        withData(\n            nameFn = { \"rejects '$it'\" },\n            \"not-a-date\",\n            \"2026-13-01\",\n            \"2026-00-15\",\n            \"\",\n        ) { input ->\n            shouldThrow\u003CDateParseException> {\n                parseDate(input)\n            }\n        }\n    }\n})\n```\n\n### 测试生命周期和固件\n\n#### BeforeTest \u002F AfterTest\n\n```kotlin\nclass DatabaseTest : FunSpec({\n    lateinit var db: Database\n\n    beforeSpec {\n        db = Database.connect(\"jdbc:h2:mem:test;DB_CLOSE_DELAY=-1\")\n        transaction(db) {\n            SchemaUtils.create(UsersTable)\n        }\n    }\n\n    afterSpec {\n        transaction(db) {\n            SchemaUtils.drop(UsersTable)\n        }\n    }\n\n    beforeTest {\n        transaction(db) {\n            UsersTable.deleteAll()\n        }\n    }\n\n    test(\"insert and retrieve user\") {\n        transaction(db) {\n            UsersTable.insert {\n                it[name] = \"Alice\"\n                it[email] = \"alice@example.com\"\n            }\n        }\n\n        val users = transaction(db) {\n            UsersTable.selectAll().map { it[UsersTable.name] }\n        }\n\n        users shouldContain \"Alice\"\n    }\n})\n```\n\n#### Kotest 扩展\n\n```kotlin\n\u002F\u002F Reusable test extension\nclass DatabaseExtension : BeforeSpecListener, AfterSpecListener {\n    lateinit var db: Database\n\n    override suspend fun beforeSpec(spec: Spec) {\n        db = Database.connect(\"jdbc:h2:mem:test;DB_CLOSE_DELAY=-1\")\n    }\n\n    override suspend fun afterSpec(spec: Spec) {\n        \u002F\u002F cleanup\n    }\n}\n\nclass UserRepositoryTest : FunSpec({\n    val dbExt = DatabaseExtension()\n    register(dbExt)\n\n    test(\"save and find user\") {\n        val repo = UserRepository(dbExt.db)\n        \u002F\u002F ...\n    }\n})\n```\n\n### Kover 覆盖率\n\n#### Gradle 配置\n\n```kotlin\n\u002F\u002F build.gradle.kts\nplugins {\n    id(\"org.jetbrains.kotlinx.kover\") version \"0.9.7\"\n}\n\nkover {\n    reports {\n        total {\n            html { onCheck = true }\n            xml { onCheck = true }\n        }\n        filters {\n            excludes {\n                classes(\"*.generated.*\", \"*.config.*\")\n            }\n        }\n        verify {\n            rule {\n                minBound(80) \u002F\u002F Fail build below 80% coverage\n            }\n        }\n    }\n}\n```\n\n#### 覆盖率命令\n\n```bash\n# Run tests with coverage\n.\u002Fgradlew koverHtmlReport\n\n# Verify coverage thresholds\n.\u002Fgradlew koverVerify\n\n# XML report for CI\n.\u002Fgradlew koverXmlReport\n\n# View HTML report (use the command for your OS)\n# macOS:   open build\u002Freports\u002Fkover\u002Fhtml\u002Findex.html\n# Linux:   xdg-open build\u002Freports\u002Fkover\u002Fhtml\u002Findex.html\n# Windows: start build\u002Freports\u002Fkover\u002Fhtml\u002Findex.html\n```\n\n#### 覆盖率目标\n\n| 代码类型 | 目标 |\n|-----------|--------|\n| 关键业务逻辑 | 100% |\n| 公共 API | 90%+ |\n| 通用代码 | 80%+ |\n| 生成的 \u002F 配置代码 | 排除 |\n\n### Ktor testApplication 测试\n\n```kotlin\nclass ApiRoutesTest : FunSpec({\n    test(\"GET \u002Fusers returns list\") {\n        testApplication {\n            application {\n                configureRouting()\n                configureSerialization()\n            }\n\n            val response = client.get(\"\u002Fusers\")\n\n            response.status shouldBe HttpStatusCode.OK\n            val users = response.body\u003CList\u003CUserResponse>>()\n            users.shouldNotBeEmpty()\n        }\n    }\n\n    test(\"POST \u002Fusers creates user\") {\n        testApplication {\n            application {\n                configureRouting()\n                configureSerialization()\n            }\n\n            val response = client.post(\"\u002Fusers\") {\n                contentType(ContentType.Application.Json)\n                setBody(CreateUserRequest(\"Alice\", \"alice@example.com\"))\n            }\n\n            response.status shouldBe HttpStatusCode.Created\n        }\n    }\n})\n```\n\n### 测试命令\n\n```bash\n# Run all tests\n.\u002Fgradlew test\n\n# Run specific test class\n.\u002Fgradlew test --tests \"com.example.UserServiceTest\"\n\n# Run specific test\n.\u002Fgradlew test --tests \"com.example.UserServiceTest.getUser returns user when found\"\n\n# Run with verbose output\n.\u002Fgradlew test --info\n\n# Run with coverage\n.\u002Fgradlew koverHtmlReport\n\n# Run detekt (static analysis)\n.\u002Fgradlew detekt\n\n# Run ktlint (formatting check)\n.\u002Fgradlew ktlintCheck\n\n# Continuous testing\n.\u002Fgradlew test --continuous\n```\n\n### 最佳实践\n\n**应做：**\n\n* 先写测试（TDD）\n* 在整个项目中一致地使用 Kotest 的规范样式\n* 对挂起函数使用 MockK 的 `coEvery`\u002F`coVerify`\n* 对协程测试使用 `runTest`\n* 测试行为，而非实现\n* 对纯函数使用基于属性的测试\n* 为清晰起见使用 `data class` 测试固件\n\n**不应做：**\n\n* 混合使用测试框架（选择 Kotest 并坚持使用）\n* 模拟数据类（使用真实实例）\n* 在协程测试中使用 `Thread.sleep()`（改用 `advanceTimeBy`）\n* 跳过 TDD 中的红色阶段\n* 直接测试私有函数\n* 忽略不稳定的测试\n\n### 与 CI\u002FCD 集成\n\n```yaml\n# GitHub Actions example\ntest:\n  runs-on: ubuntu-latest\n  steps:\n    - uses: actions\u002Fcheckout@v4\n    - uses: actions\u002Fsetup-java@v4\n      with:\n        distribution: 'temurin'\n        java-version: '21'\n\n    - name: Run tests with coverage\n      run: .\u002Fgradlew test koverXmlReport\n\n    - name: Verify coverage\n      run: .\u002Fgradlew koverVerify\n\n    - name: Upload coverage\n      uses: codecov\u002Fcodecov-action@v5\n      with:\n        files: build\u002Freports\u002Fkover\u002Freport.xml\n        token: ${{ secrets.CODECOV_TOKEN }}\n```\n\n**记住**：测试就是文档。它们展示了你的 Kotlin 代码应如何使用。使用 Kotest 富有表现力的匹配器使测试可读，并使用 MockK 来清晰地模拟依赖项。\n","# Kotlin 测试模式\n\n遵循 TDD 方法论，使用 Kotest 和 MockK 编写可靠、可维护测试的全面 Kotlin 测试模式。\n\n## 何时使用\n\n* 编写新的 Kotlin 函数或类\n* 为现有 Kotlin 代码添加测试覆盖率\n* 实现基于属性的测试\n* 在 Kotlin 项目中遵循 TDD 工作流\n* 为代码覆盖率配置 Kover\n\n## 工作原理\n\n1. **确定目标代码** — 找到要测试的函数、类或模块\n2. **编写 Kotest 规范** — 选择与测试范围匹配的规范样式（StringSpec、FunSpec、BehaviorSpec）\n3. **模拟依赖项** — 使用 MockK 来隔离被测单元\n4. **运行测试（红色阶段）** — 验证测试是否按预期失败\n5. **实现代码（绿色阶段）** — 编写最少的代码以使测试通过\n6. **重构** — 改进实现，同时保持测试通过\n7. **检查覆盖率** — 运行 `.\u002Fgradlew koverHtmlReport` 并验证 80%+ 的覆盖率\n\n## 示例\n\n以下部分包含每个测试模式的详细、可运行示例：\n\n### 快速参考\n\n* **Kotest 规范** — [Kotest 规范样式](#kotest-规范样式) 中的 StringSpec、FunSpec、BehaviorSpec、DescribeSpec 示例\n* **模拟** — [MockK](#mockk) 中的 MockK 设置、协程模拟、参数捕获\n* **TDD 演练** — [Kotlin 的 TDD 工作流](#kotlin-的-tdd-工作流) 中 EmailValidator 的完整 RED\u002FGREEN\u002FREFACTOR 周期\n* **覆盖率** — [Kover 覆盖率](#kover-覆盖率) 中的 Kover 配置和命令\n* **Ktor 测试** — [Ktor testApplication 测试](#ktor-testapplication-测试) 中的 testApplication 设置\n\n### Kotlin 的 TDD 工作流\n\n#### RED-GREEN-REFACTOR 周期\n\n```\nRED     -> 首先编写一个失败的测试\nGREEN   -> 编写最少的代码使测试通过\nREFACTOR -> 改进代码同时保持测试通过\nREPEAT  -> 继续下一个需求\n```\n\n#### Kotlin 中逐步进行 TDD\n\n```kotlin\n\u002F\u002F Step 1: Define the interface\u002Fsignature\n\u002F\u002F EmailValidator.kt\npackage com.example.validator\n\nfun validateEmail(email: String): Result\u003CString> {\n    TODO(\"not implemented\")\n}\n\n\u002F\u002F Step 2: Write failing test (RED)\n\u002F\u002F EmailValidatorTest.kt\npackage com.example.validator\n\nimport io.kotest.core.spec.style.StringSpec\nimport io.kotest.matchers.result.shouldBeFailure\nimport io.kotest.matchers.result.shouldBeSuccess\n\nclass EmailValidatorTest : StringSpec({\n    \"valid email returns success\" {\n        validateEmail(\"user@example.com\").shouldBeSuccess(\"user@example.com\")\n    }\n\n    \"empty email returns failure\" {\n        validateEmail(\"\").shouldBeFailure()\n    }\n\n    \"email without @ returns failure\" {\n        validateEmail(\"userexample.com\").shouldBeFailure()\n    }\n})\n\n\u002F\u002F Step 3: Run tests - verify FAIL\n\u002F\u002F $ .\u002Fgradlew test\n\u002F\u002F EmailValidatorTest > valid email returns success FAILED\n\u002F\u002F   kotlin.NotImplementedError: An operation is not implemented\n\n\u002F\u002F Step 4: Implement minimal code (GREEN)\nfun validateEmail(email: String): Result\u003CString> {\n    if (email.isBlank()) return Result.failure(IllegalArgumentException(\"Email cannot be blank\"))\n    if ('@' !in email) return Result.failure(IllegalArgumentException(\"Email must contain @\"))\n    val regex = Regex(\"^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\\\.[A-Za-z]{2,}$\")\n    if (!regex.matches(email)) return Result.failure(IllegalArgumentException(\"Invalid email format\"))\n    return Result.success(email)\n}\n\n\u002F\u002F Step 5: Run tests - verify PASS\n\u002F\u002F $ .\u002Fgradlew test\n\u002F\u002F EmailValidatorTest > valid email returns success PASSED\n\u002F\u002F EmailValidatorTest > empty email returns failure PASSED\n\u002F\u002F EmailValidatorTest > email without @ returns failure PASSED\n\n\u002F\u002F Step 6: Refactor if needed, verify tests still pass\n```\n\n### Kotest 规范样式\n\n#### StringSpec（最简单）\n\n```kotlin\nclass CalculatorTest : StringSpec({\n    \"add two positive numbers\" {\n        Calculator.add(2, 3) shouldBe 5\n    }\n\n    \"add negative numbers\" {\n        Calculator.add(-1, -2) shouldBe -3\n    }\n\n    \"add zero\" {\n        Calculator.add(0, 5) shouldBe 5\n    }\n})\n```\n\n#### FunSpec（类似 JUnit）\n\n```kotlin\nclass UserServiceTest : FunSpec({\n    val repository = mockk\u003CUserRepository>()\n    val service = UserService(repository)\n\n    test(\"getUser returns user when found\") {\n        val expected = User(id = \"1\", name = \"Alice\")\n        coEvery { repository.findById(\"1\") } returns expected\n\n        val result = service.getUser(\"1\")\n\n        result shouldBe expected\n    }\n\n    test(\"getUser throws when not found\") {\n        coEvery { repository.findById(\"999\") } returns null\n\n        shouldThrow\u003CUserNotFoundException> {\n            service.getUser(\"999\")\n        }\n    }\n})\n```\n\n#### BehaviorSpec（BDD 风格）\n\n```kotlin\nclass OrderServiceTest : BehaviorSpec({\n    val repository = mockk\u003COrderRepository>()\n    val paymentService = mockk\u003CPaymentService>()\n    val service = OrderService(repository, paymentService)\n\n    Given(\"a valid order request\") {\n        val request = CreateOrderRequest(\n            userId = \"user-1\",\n            items = listOf(OrderItem(\"product-1\", quantity = 2)),\n        )\n\n        When(\"the order is placed\") {\n            coEvery { paymentService.charge(any()) } returns PaymentResult.Success\n            coEvery { repository.save(any()) } answers { firstArg() }\n\n            val result = service.placeOrder(request)\n\n            Then(\"it should return a confirmed order\") {\n                result.status shouldBe OrderStatus.CONFIRMED\n            }\n\n            Then(\"it should charge payment\") {\n                coVerify(exactly = 1) { paymentService.charge(any()) }\n            }\n        }\n\n        When(\"payment fails\") {\n            coEvery { paymentService.charge(any()) } returns PaymentResult.Declined\n\n            Then(\"it should throw PaymentException\") {\n                shouldThrow\u003CPaymentException> {\n                    service.placeOrder(request)\n                }\n            }\n        }\n    }\n})\n```\n\n#### DescribeSpec（RSpec 风格）\n\n```kotlin\nclass UserValidatorTest : DescribeSpec({\n    describe(\"validateUser\") {\n        val validator = UserValidator()\n\n        context(\"with valid input\") {\n            it(\"accepts a normal user\") {\n                val user = CreateUserRequest(\"Alice\", \"alice@example.com\")\n                validator.validate(user).shouldBeValid()\n            }\n        }\n\n        context(\"with invalid name\") {\n            it(\"rejects blank name\") {\n                val user = CreateUserRequest(\"\", \"alice@example.com\")\n                validator.validate(user).shouldBeInvalid()\n            }\n\n            it(\"rejects name exceeding max length\") {\n                val user = CreateUserRequest(\"A\".repeat(256), \"alice@example.com\")\n                validator.validate(user).shouldBeInvalid()\n            }\n        }\n    }\n})\n```\n\n### Kotest 匹配器\n\n#### 核心匹配器\n\n```kotlin\nimport io.kotest.matchers.shouldBe\nimport io.kotest.matchers.shouldNotBe\nimport io.kotest.matchers.string.*\nimport io.kotest.matchers.collections.*\nimport io.kotest.matchers.nulls.*\n\n\u002F\u002F Equality\nresult shouldBe expected\nresult shouldNotBe unexpected\n\n\u002F\u002F Strings\nname shouldStartWith \"Al\"\nname shouldEndWith \"ice\"\nname shouldContain \"lic\"\nname shouldMatch Regex(\"[A-Z][a-z]+\")\nname.shouldBeBlank()\n\n\u002F\u002F Collections\nlist shouldContain \"item\"\nlist shouldHaveSize 3\nlist.shouldBeSorted()\nlist.shouldContainAll(\"a\", \"b\", \"c\")\nlist.shouldBeEmpty()\n\n\u002F\u002F Nulls\nresult.shouldNotBeNull()\nresult.shouldBeNull()\n\n\u002F\u002F Types\nresult.shouldBeInstanceOf\u003CUser>()\n\n\u002F\u002F Numbers\ncount shouldBeGreaterThan 0\nprice shouldBeInRange 1.0..100.0\n\n\u002F\u002F Exceptions\nshouldThrow\u003CIllegalArgumentException> {\n    validateAge(-1)\n}.message shouldBe \"Age must be positive\"\n\nshouldNotThrow\u003CException> {\n    validateAge(25)\n}\n```\n\n#### 自定义匹配器\n\n```kotlin\nfun beActiveUser() = object : Matcher\u003CUser> {\n    override fun test(value: User) = MatcherResult(\n        value.isActive && value.lastLogin != null,\n        { \"User ${value.id} should be active with a last login\" },\n        { \"User ${value.id} should not be active\" },\n    )\n}\n\n\u002F\u002F Usage\nuser should beActiveUser()\n```\n\n### MockK\n\n#### 基本模拟\n\n```kotlin\nclass UserServiceTest : FunSpec({\n    val repository = mockk\u003CUserRepository>()\n    val logger = mockk\u003CLogger>(relaxed = true) \u002F\u002F Relaxed: returns defaults\n    val service = UserService(repository, logger)\n\n    beforeTest {\n        clearMocks(repository, logger)\n    }\n\n    test(\"findUser delegates to repository\") {\n        val expected = User(id = \"1\", name = \"Alice\")\n        every { repository.findById(\"1\") } returns expected\n\n        val result = service.findUser(\"1\")\n\n        result shouldBe expected\n        verify(exactly = 1) { repository.findById(\"1\") }\n    }\n\n    test(\"findUser returns null for unknown id\") {\n        every { repository.findById(any()) } returns null\n\n        val result = service.findUser(\"unknown\")\n\n        result.shouldBeNull()\n    }\n})\n```\n\n#### 协程模拟\n\n```kotlin\nclass AsyncUserServiceTest : FunSpec({\n    val repository = mockk\u003CUserRepository>()\n    val service = UserService(repository)\n\n    test(\"getUser suspending function\") {\n        coEvery { repository.findById(\"1\") } returns User(id = \"1\", name = \"Alice\")\n\n        val result = service.getUser(\"1\")\n\n        result.name shouldBe \"Alice\"\n        coVerify { repository.findById(\"1\") }\n    }\n\n    test(\"getUser with delay\") {\n        coEvery { repository.findById(\"1\") } coAnswers {\n            delay(100) \u002F\u002F Simulate async work\n            User(id = \"1\", name = \"Alice\")\n        }\n\n        val result = service.getUser(\"1\")\n        result.name shouldBe \"Alice\"\n    }\n})\n```\n\n#### 参数捕获\n\n```kotlin\ntest(\"save captures the user argument\") {\n    val slot = slot\u003CUser>()\n    coEvery { repository.save(capture(slot)) } returns Unit\n\n    service.createUser(CreateUserRequest(\"Alice\", \"alice@example.com\"))\n\n    slot.captured.name shouldBe \"Alice\"\n    slot.captured.email shouldBe \"alice@example.com\"\n    slot.captured.id.shouldNotBeNull()\n}\n```\n\n#### 间谍和部分模拟\n\n```kotlin\ntest(\"spy on real object\") {\n    val realService = UserService(repository)\n    val spy = spyk(realService)\n\n    every { spy.generateId() } returns \"fixed-id\"\n\n    spy.createUser(request)\n\n    verify { spy.generateId() } \u002F\u002F Overridden\n    \u002F\u002F Other methods use real implementation\n}\n```\n\n### 协程测试\n\n#### 用于挂起函数的 runTest\n\n```kotlin\nimport kotlinx.coroutines.test.runTest\n\nclass CoroutineServiceTest : FunSpec({\n    test(\"concurrent fetches complete together\") {\n        runTest {\n            val service = DataService(testScope = this)\n\n            val result = service.fetchAllData()\n\n            result.users.shouldNotBeEmpty()\n            result.products.shouldNotBeEmpty()\n        }\n    }\n\n    test(\"timeout after delay\") {\n        runTest {\n            val service = SlowService()\n\n            shouldThrow\u003CTimeoutCancellationException> {\n                withTimeout(100) {\n                    service.slowOperation() \u002F\u002F Takes > 100ms\n                }\n            }\n        }\n    }\n})\n```\n\n#### 测试 Flow\n\n```kotlin\nimport io.kotest.matchers.collections.shouldContainInOrder\nimport kotlinx.coroutines.flow.MutableSharedFlow\nimport kotlinx.coroutines.flow.toList\nimport kotlinx.coroutines.launch\nimport kotlinx.coroutines.test.advanceTimeBy\nimport kotlinx.coroutines.test.runTest\n\nclass FlowServiceTest : FunSpec({\n    test(\"observeUsers emits updates\") {\n        runTest {\n            val service = UserFlowService()\n\n            val emissions = service.observeUsers()\n                .take(3)\n                .toList()\n\n            emissions shouldHaveSize 3\n            emissions.last().shouldNotBeEmpty()\n        }\n    }\n\n    test(\"searchUsers debounces input\") {\n        runTest {\n            val service = SearchService()\n            val queries = MutableSharedFlow\u003CString>()\n\n            val results = mutableListOf\u003CList\u003CUser>>()\n            val job = launch {\n                service.searchUsers(queries).collect { results.add(it) }\n            }\n\n            queries.emit(\"a\")\n            queries.emit(\"ab\")\n            queries.emit(\"abc\") \u002F\u002F Only this should trigger search\n            advanceTimeBy(500)\n\n            results shouldHaveSize 1\n            job.cancel()\n        }\n    }\n})\n```\n\n#### TestDispatcher\n\n```kotlin\nimport kotlinx.coroutines.test.StandardTestDispatcher\nimport kotlinx.coroutines.test.advanceUntilIdle\n\nclass DispatcherTest : FunSpec({\n    test(\"uses test dispatcher for controlled execution\") {\n        val dispatcher = StandardTestDispatcher()\n\n        runTest(dispatcher) {\n            var completed = false\n\n            launch {\n                delay(1000)\n                completed = true\n            }\n\n            completed shouldBe false\n            advanceTimeBy(1000)\n            completed shouldBe true\n        }\n    }\n})\n```\n\n### 基于属性的测试\n\n#### Kotest 属性测试\n\n```kotlin\nimport io.kotest.core.spec.style.FunSpec\nimport io.kotest.property.Arb\nimport io.kotest.property.arbitrary.*\nimport io.kotest.property.forAll\nimport io.kotest.property.checkAll\nimport kotlinx.serialization.json.Json\nimport kotlinx.serialization.encodeToString\nimport kotlinx.serialization.decodeFromString\n\n\u002F\u002F Note: The serialization roundtrip test below requires the User data class\n\u002F\u002F to be annotated with @Serializable (from kotlinx.serialization).\n\nclass PropertyTest : FunSpec({\n    test(\"string reverse is involutory\") {\n        forAll\u003CString> { s ->\n            s.reversed().reversed() == s\n        }\n    }\n\n    test(\"list sort is idempotent\") {\n        forAll(Arb.list(Arb.int())) { list ->\n            list.sorted() == list.sorted().sorted()\n        }\n    }\n\n    test(\"serialization roundtrip preserves data\") {\n        checkAll(Arb.bind(Arb.string(1..50), Arb.string(5..100)) { name, email ->\n            User(name = name, email = \"$email@test.com\")\n        }) { user ->\n            val json = Json.encodeToString(user)\n            val decoded = Json.decodeFromString\u003CUser>(json)\n            decoded shouldBe user\n        }\n    }\n})\n```\n\n#### 自定义生成器\n\n```kotlin\nval userArb: Arb\u003CUser> = Arb.bind(\n    Arb.string(minSize = 1, maxSize = 50),\n    Arb.email(),\n    Arb.enum\u003CRole>(),\n) { name, email, role ->\n    User(\n        id = UserId(UUID.randomUUID().toString()),\n        name = name,\n        email = Email(email),\n        role = role,\n    )\n}\n\nval moneyArb: Arb\u003CMoney> = Arb.bind(\n    Arb.long(1L..1_000_000L),\n    Arb.enum\u003CCurrency>(),\n) { amount, currency ->\n    Money(amount, currency)\n}\n```\n\n### 数据驱动测试\n\n#### Kotest 中的 withData\n\n```kotlin\nclass ParserTest : FunSpec({\n    context(\"parsing valid dates\") {\n        withData(\n            \"2026-01-15\" to LocalDate(2026, 1, 15),\n            \"2026-12-31\" to LocalDate(2026, 12, 31),\n            \"2000-01-01\" to LocalDate(2000, 1, 1),\n        ) { (input, expected) ->\n            parseDate(input) shouldBe expected\n        }\n    }\n\n    context(\"rejecting invalid dates\") {\n        withData(\n            nameFn = { \"rejects '$it'\" },\n            \"not-a-date\",\n            \"2026-13-01\",\n            \"2026-00-15\",\n            \"\",\n        ) { input ->\n            shouldThrow\u003CDateParseException> {\n                parseDate(input)\n            }\n        }\n    }\n})\n```\n\n### 测试生命周期和固件\n\n#### BeforeTest \u002F AfterTest\n\n```kotlin\nclass DatabaseTest : FunSpec({\n    lateinit var db: Database\n\n    beforeSpec {\n        db = Database.connect(\"jdbc:h2:mem:test;DB_CLOSE_DELAY=-1\")\n        transaction(db) {\n            SchemaUtils.create(UsersTable)\n        }\n    }\n\n    afterSpec {\n        transaction(db) {\n            SchemaUtils.drop(UsersTable)\n        }\n    }\n\n    beforeTest {\n        transaction(db) {\n            UsersTable.deleteAll()\n        }\n    }\n\n    test(\"insert and retrieve user\") {\n        transaction(db) {\n            UsersTable.insert {\n                it[name] = \"Alice\"\n                it[email] = \"alice@example.com\"\n            }\n        }\n\n        val users = transaction(db) {\n            UsersTable.selectAll().map { it[UsersTable.name] }\n        }\n\n        users shouldContain \"Alice\"\n    }\n})\n```\n\n#### Kotest 扩展\n\n```kotlin\n\u002F\u002F Reusable test extension\nclass DatabaseExtension : BeforeSpecListener, AfterSpecListener {\n    lateinit var db: Database\n\n    override suspend fun beforeSpec(spec: Spec) {\n        db = Database.connect(\"jdbc:h2:mem:test;DB_CLOSE_DELAY=-1\")\n    }\n\n    override suspend fun afterSpec(spec: Spec) {\n        \u002F\u002F cleanup\n    }\n}\n\nclass UserRepositoryTest : FunSpec({\n    val dbExt = DatabaseExtension()\n    register(dbExt)\n\n    test(\"save and find user\") {\n        val repo = UserRepository(dbExt.db)\n        \u002F\u002F ...\n    }\n})\n```\n\n### Kover 覆盖率\n\n#### Gradle 配置\n\n```kotlin\n\u002F\u002F build.gradle.kts\nplugins {\n    id(\"org.jetbrains.kotlinx.kover\") version \"0.9.7\"\n}\n\nkover {\n    reports {\n        total {\n            html { onCheck = true }\n            xml { onCheck = true }\n        }\n        filters {\n            excludes {\n                classes(\"*.generated.*\", \"*.config.*\")\n            }\n        }\n        verify {\n            rule {\n                minBound(80) \u002F\u002F Fail build below 80% coverage\n            }\n        }\n    }\n}\n```\n\n#### 覆盖率命令\n\n```bash\n# Run tests with coverage\n.\u002Fgradlew koverHtmlReport\n\n# Verify coverage thresholds\n.\u002Fgradlew koverVerify\n\n# XML report for CI\n.\u002Fgradlew koverXmlReport\n\n# View HTML report (use the command for your OS)\n# macOS:   open build\u002Freports\u002Fkover\u002Fhtml\u002Findex.html\n# Linux:   xdg-open build\u002Freports\u002Fkover\u002Fhtml\u002Findex.html\n# Windows: start build\u002Freports\u002Fkover\u002Fhtml\u002Findex.html\n```\n\n#### 覆盖率目标\n\n| 代码类型 | 目标 |\n|-----------|--------|\n| 关键业务逻辑 | 100% |\n| 公共 API | 90%+ |\n| 通用代码 | 80%+ |\n| 生成的 \u002F 配置代码 | 排除 |\n\n### Ktor testApplication 测试\n\n```kotlin\nclass ApiRoutesTest : FunSpec({\n    test(\"GET \u002Fusers returns list\") {\n        testApplication {\n            application {\n                configureRouting()\n                configureSerialization()\n            }\n\n            val response = client.get(\"\u002Fusers\")\n\n            response.status shouldBe HttpStatusCode.OK\n            val users = response.body\u003CList\u003CUserResponse>>()\n            users.shouldNotBeEmpty()\n        }\n    }\n\n    test(\"POST \u002Fusers creates user\") {\n        testApplication {\n            application {\n                configureRouting()\n                configureSerialization()\n            }\n\n            val response = client.post(\"\u002Fusers\") {\n                contentType(ContentType.Application.Json)\n                setBody(CreateUserRequest(\"Alice\", \"alice@example.com\"))\n            }\n\n            response.status shouldBe HttpStatusCode.Created\n        }\n    }\n})\n```\n\n### 测试命令\n\n```bash\n# Run all tests\n.\u002Fgradlew test\n\n# Run specific test class\n.\u002Fgradlew test --tests \"com.example.UserServiceTest\"\n\n# Run specific test\n.\u002Fgradlew test --tests \"com.example.UserServiceTest.getUser returns user when found\"\n\n# Run with verbose output\n.\u002Fgradlew test --info\n\n# Run with coverage\n.\u002Fgradlew koverHtmlReport\n\n# Run detekt (static analysis)\n.\u002Fgradlew detekt\n\n# Run ktlint (formatting check)\n.\u002Fgradlew ktlintCheck\n\n# Continuous testing\n.\u002Fgradlew test --continuous\n```\n\n### 最佳实践\n\n**应做：**\n\n* 先写测试（TDD）\n* 在整个项目中一致地使用 Kotest 的规范样式\n* 对挂起函数使用 MockK 的 `coEvery`\u002F`coVerify`\n* 对协程测试使用 `runTest`\n* 测试行为，而非实现\n* 对纯函数使用基于属性的测试\n* 为清晰起见使用 `data class` 测试固件\n\n**不应做：**\n\n* 混合使用测试框架（选择 Kotest 并坚持使用）\n* 模拟数据类（使用真实实例）\n* 在协程测试中使用 `Thread.sleep()`（改用 `advanceTimeBy`）\n* 跳过 TDD 中的红色阶段\n* 直接测试私有函数\n* 忽略不稳定的测试\n\n### 与 CI\u002FCD 集成\n\n```yaml\n# GitHub Actions example\ntest:\n  runs-on: ubuntu-latest\n  steps:\n    - uses: actions\u002Fcheckout@v4\n    - uses: actions\u002Fsetup-java@v4\n      with:\n        distribution: 'temurin'\n        java-version: '21'\n\n    - name: Run tests with coverage\n      run: .\u002Fgradlew test koverXmlReport\n\n    - name: Verify coverage\n      run: .\u002Fgradlew koverVerify\n\n    - name: Upload coverage\n      uses: codecov\u002Fcodecov-action@v5\n      with:\n        files: build\u002Freports\u002Fkover\u002Freport.xml\n        token: ${{ secrets.CODECOV_TOKEN }}\n```\n\n**记住**：测试就是文档。它们展示了你的 Kotlin 代码应如何使用。使用 Kotest 富有表现力的匹配器使测试可读，并使用 MockK 来清晰地模拟依赖项。\n",{"name":5,"origin":24,"description":7},"ECC","master","d6ca01da0f24a3b0e26e4a8b7b66cbd25d429f5d","everything-claude-code\u002Fdocs\u002Fzh-CN\u002Fskills\u002Fkotlin-testing",0,"https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills","https:\u002F\u002Fgithub.com\u002FSriramGandhiS","https:\u002F\u002Fsriram.website\u002F","Curious guy who keeps tinkering until something works","2026-05-20 16:21:34",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add SriramGandhiS\u002FSkills --skill kotlin-testing",{"tool":40,"command":41},"bunx","bunx skills add SriramGandhiS\u002FSkills --skill kotlin-testing",{"tool":43,"command":44},"pnpm","pnpm dlx skills add SriramGandhiS\u002FSkills --skill kotlin-testing","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Feverything-claude-code\u002Fdocs\u002Fzh-CN\u002Fskills\u002Fkotlin-testing\u002FSKILL.md",true,[],[49,57,62,68,75,82],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":56},"01M732609EPJWV13PVTX3GT4TM","webgpu-threejs-tsl","Comprehensive guide for developing WebGPU-enabled Three.js applications using TSL (Three.js Shading Language). Covers WebGPU renderer setup, TSL syntax and node materials, compute shaders, post-processing effects, and WGSL integration. Use this skill when working with Three.js WebGPU, TSL shaders, node materials, or GPU compute in Three.js.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fwebgpu-threejs-tsl\u002Fskills\u002Fwebgpu-threejs-tsl\u002FSKILL.md",[],[],"2026-11-11 15:11:14",{"skillNo":58,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":56},"01M7325XM47AGWB6K6C4VXKE6B","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fwebgpu-threejs-tsl\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":56},"01M7325WP6DES69JKC840VMFEP","verification-loop","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Fverification-loop\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":56},"01M7325TFQF1DZTQ6J3WGQQ1VR","tdd-workflow","Use this skill when writing new features, fixing bugs, or refactoring code. Enforces test-driven development with 80%+ coverage including unit, integration, and E2E tests.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Ftdd-workflow\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":56},"01M7325RGV9AY9PK92D2V8KKPW","strategic-compact","Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Fstrategic-compact\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":56},"01M7325MZC28SE86E7NMCNEFS4","security-review","Use this skill when adding authentication, handling user input, working with secrets, creating API endpoints, or implementing payment\u002Fsensitive features. Provides comprehensive security checklist and patterns.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Fsecurity-review\u002FSKILL.md",[],[]]