Gradle 默认的 test 任务仅显示类名（如 ExampleSpec），不包含包路径；本文介绍通过配置 afterTest 回调与 testLogging，精准控制测试结果日志格式，强制显示带包名的全限定类名（如 com.company.ExampleSpec），并支持彩色状态标识。
gradle 默认的 `test` 任务仅显示类名（如 `examplespec`），不包含包路径；本文介绍通过配置 `aftertest` 回调与 `testlogging`，精准控制测试结果日志格式，强制显示带包名的全限定类名（如 `com.company.examplespec`），并支持彩色状态标识。
在 Gradle 中，测试执行日志的默认格式（如 ExampleSpec > get all examples PASSED）确实省略了包名，降低了大型项目中测试定位的准确性。虽然 Gradle 并未提供开箱即用的“显示全限定类名”开关，但可通过 Test 任务的 afterTest 生命周期钩子完全自定义输出行为。
以下是在 build.gradle（Groovy DSL）中推荐的配置方案：
String ANSI_RESET = "\u001B[0m"
String ANSI_RED = "\u001B[31m" // 红色：失败
String ANSI_GREEN = "\u001B[32m" // 绿色：通过
String ANSI_YELLOW = "\u001B[33m" // 黄色：跳过
test {
useJUnitPlatform() // 推荐显式声明，兼容 JUnit 5+；若用 JUnit 4，改用 useJUnit()
// 基础日志增强：仅对失败用例输出异常堆栈
testLogging {
events "failed"
showExceptions true
exceptionFormat "full"
// 可选：启用此行可隐藏默认简短日志（避免重复）
// showStandardStreams = false
}
// 核心：重写每条测试结果的输出格式
afterTest { TestDescriptor descriptor, TestResult result ->
String status
if (result.resultType == org.gradle.api.tasks.testing.TestResult.ResultType.FAILURE) {
status = "${ANSI_RED}FAILED${ANSI_RESET}"
} else if (result.resultType == org.gradle.api.tasks.testing.TestResult.ResultType.SKIPPED) {
status = "${ANSI_YELLOW}SKIPPED${ANSI_RESET}"
} else {
status = "${ANSI_GREEN}PASSED${ANSI_RESET}"
}
println "${descriptor.className} > ${descriptor.name} ${status}"
}
}
✅ 效果示例：
执行 ./gradlew test 后，终端将输出类似：
com.company.service.ExampleServiceTest > should return all examples PASSED com.company.api.ExampleControllerTest > returns 200 for valid request FAILED
⚠️ 注意事项：
-
descriptor.className自动返回全限定类名（含包路径），无需额外解析； -
afterTest在每个测试方法执行后触发，因此descriptor.name是方法名，descriptor.className是测试类全名； - 若同时启用
testLogging.events "passed"，会导致默认日志与afterTest输出重复，建议关闭冗余事件（如注释中所示）； - ANSI 颜色代码在 Windows PowerShell / Git Bash / macOS/Linux 终端中均有效；Windows CMD 需启用虚拟终端支持（Gradle 6.7+ 默认兼容）；
- 使用 Kotlin DSL？语法略有差异：需将
afterTest替换为addTestListener(object : TestListener { ... })，但逻辑一致。
该方案兼顾可读性、调试效率与跨环境兼容性，是 Gradle 测试日志定制化实践中的稳定选择。
