本文介绍如何将自定义源集（如 `testcommons`）的编译输出同时注入到多个 gradle 测试套件（如 `test` 和 `itest`）中，实现测试工具类、共享配置等代码的跨套件复用。
在 Gradle 8.2+ 的新测试套件模型（testing.suites）下，不同测试套件（如单元测试 test、集成测试 itest）默认拥有独立的类路径。若你定义了用于存放通用测试辅助代码的自定义源集（如 testcommons），需显式将其编译输出（即 sourceSets["testcommons"].output）作为依赖添加到各目标测试套件中，才能确保其类对测试代码可见。
✅ 正确配置步骤
- 先声明 sourceSets：testcommons 源集定义必须位于所有引用它的配置之前（Gradle DSL 执行顺序敏感）；
- 为每个测试套件添加依赖：使用 implementation(sourceSets["testcommons"].output) 将其字节码（含 classes 和 resources）纳入类路径；
- 保持依赖继承关系清晰：无需手动配置 configurations 继承（如 itestImplementation.extendsFrom testImplementation），因为 output 已包含完整产物，直接依赖更可靠。
以下是整合后的完整 build.gradle 片段（Kotlin DSL 风格亦可类推）：
// Step 1: 定义 testcommons 源集（务必放在最前！）
sourceSets {
testcommons {
java {
srcDir 'src/testcommons/java'
}
resources {
srcDir 'src/testcommons/resources'
}
}
}
// Step 2: 配置 testing.suites，为每个套件注入 testcommons 输出
testing {
suites {
test {
useJUnitJupiter()
dependencies {
implementation(sourceSets["testcommons"].output)
}
}
itest(JvmTestSuite) {
testType = TestSuiteType.INTEGRATION_TEST
dependencies {
implementation project()
implementation(sourceSets["testcommons"].output) // 同样注入！
}
}
}
}⚠️ 注意事项
- 声明顺序至关重要：sourceSets { ... } 块必须出现在 testing { ... } 之前，否则 sourceSets["testcommons"] 将解析失败；
- output 包含全部产物：sourceSets["testcommons"].output 自动包含编译后的 .class 文件和 resources 目录内容，无需额外配置；
- 避免重复依赖传递：不要在 testcommons 中引入 testImplementation 范围的依赖（如 JUnit），否则可能引发冲突；建议其仅包含纯工具类与资源；
- 验证是否生效：运行 ./gradlew testClasses itestClasses --info，检查日志中是否包含 testcommons 的编译任务（如 compileTestcommonsJava），并确认测试类能成功 import 其中定义的类型。
通过该方式，你可在不复制代码、不创建独立模块的前提下，安全、高效地在多测试套件间共享测试基础设施，提升项目可维护性与一致性。
