应在dependencies块中用testImplementation声明kotlin-test-junit5（如"org.jetbrains.kotlin:kotlin-test-junit5:1.9.22"），并显式添加testRuntimeOnly("org.junit.jupiter:junit-jupiter-engine:5.10.2")，确保版本与Kotlin编译器对齐且JVM目标一致，避免NoClassDefFoundError或测试运行失败。
怎么在 build.gradle.kts 里声明 kotlin-test 依赖
直接在 dependencies 块中添加 testImplementation 即可，但要注意版本对齐和 JVM 目标一致性。kotlin-test 不是单个库，而是包含多个模块（如 kotlin-test-junit5、kotlin-test-assertions），必须按需引入。
常见错误是只加 kotlin-test（它只是空的元包，不提供实际功能），或版本与 Kotlin 编译器不匹配导致 NoClassDefFoundError。
- 用
kotlin-test-junit5（推荐）：适用于 JUnit 5 环境，支持assertTrue、assertEquals等扩展函数 - 确保
kotlin.version和kotlin-test版本一致（例如 Kotlin 1.9.22 →kotlin-test-junit5:1.9.22） - 如果项目已启用
kotlin("jvm")插件，无需额外配置源集；否则需确认test源集的kotlin目录被识别（默认是src/test/kotlin）
示例（Kotlin 1.9.22 + JUnit 5）：
dependencies {
testImplementation("org.jetbrains.kotlin:kotlin-test-junit5:1.9.22")
testRuntimeOnly("org.junit.jupiter:junit-jupiter-engine:5.10.2")
}
为什么 testImplementation 里还要显式加 junit-jupiter-engine
因为 kotlin-test-junit5 只是 Kotlin 封装层，它依赖 JUnit 5 的运行时引擎来执行测试。Gradle 默认不会传递 runtimeOnly 依赖，所以必须手动声明 testRuntimeOnly，否则运行 ./gradlew test 会报 TestEngine with ID 'junit-jupiter' could not be found。
注意：junit-jupiter-engine 版本要与项目中其他 JUnit 5 依赖（如 junit-jupiter-api）保持兼容，建议统一用 JUnit 官方推荐的组合（如 5.10.x 系列）。
- 不加
testRuntimeOnly→ 测试编译通过但运行失败 - 版本错配（如引擎用 5.9，API 用 5.10）→
IncompatibleClassChangeError - 用
testImplementation替代testRuntimeOnly引入引擎 → 可能污染编译类路径，非必要
如何让 IDE 正确识别 kotlin-test 的断言函数
IntelliJ / Android Studio 有时不自动导入 kotlin.test.* 扩展函数（比如 assertTrue），即使依赖已生效。这不是配置问题，而是 IDE 缓存或解析延迟导致。
- 先确认
src/test/kotlin已被标记为 Test Sources Root（右键目录 → Mark as Test Sources） - 执行
File → Reload project from Gradle或点击 Gradle 工具窗的刷新按钮 - 若仍无代码补全，在测试文件顶部手动加
import kotlin.test.*，IDE 通常会后续自动补全 - 避免混用
org.junit.jupiter.api.Assertions和kotlin.test断言——两者语法不同（如assertEquals(expected, actual)vsassertEquals(actual, expected)），容易写反
多模块项目里怎么复用 kotlin-test 配置
不要在每个子模块的 build.gradle.kts 中重复写依赖。根项目的 subprojects 块是最简洁的统一入口。
关键点在于：kotlin-test 是测试期依赖，不能提升到 allprojects（那会污染主源集），也别用 buildSrc 封装——它不是版本管理场景，而是标准依赖注入。
- 在根项目
build.gradle.kts中写：
subprojects {
dependencies {
testImplementation("org.jetbrains.kotlin:kotlin-test-junit5:1.9.22")
testRuntimeOnly("org.junit.jupiter:junit-jupiter-engine:5.10.2")
}
}
这样所有子模块自动继承，且各自保持独立的测试类路径，不会相互干扰。
真正容易被忽略的是：如果你在某个模块里用了 kotlin-test-js 或 kotlin-test-native，它们和 JVM 版本完全不兼容，必须严格按目标平台选包——跨平台项目尤其要核对 sourceSets 绑定关系。
