1. 简介
跳过测试通常不是一个好主意，❌这可能会掩盖潜在的问题，甚至导致线上故障。但在某些特定场景下，临时跳过测试确实能帮我们节省时间，✅比如正在开发一个新功能，想快速验证中间构建结果时。
这种操作属于“开发期权宜之计”，切记不要提交到主干或 CI 流水线中。⚠️忽略测试极有可能引发严重问题，所以务必谨慎使用。
本文将介绍在使用 Gradle 构建工具时，如何跳过测试的几种常用方式。
2. 使用命令行参数
先来看一个简单的测试用例：
@Test
void skippableTest() {
Assertions.assertTrue(true);
}
正常执行构建命令：
gradle build
你会看到类似如下任务输出：
> ...
> Task :compileTestJava
> Task :processTestResources NO-SOURCE
> Task :testClasses
> Task :test
> ...
Gradle 提供了 -x 或 --exclude-task 参数，用于跳过指定任务。
要跳过测试，只需加上 -x test：
gradle build -x test
此时输出变为：
> Task :compileJava NO-SOURCE
> Task :processResources NO-SOURCE
> Task :classes UP-TO-DATE
> Task :jar
> Task :assemble
> Task :check
> Task :build
可以看到，test 任务被完全跳过，连测试类都没有编译，效率拉满。
✅ 小贴士：这个方法最简单粗暴，适合本地快速验证，但不适合复杂条件控制。
3. 使用 Gradle 构建脚本
相比命令行，通过 build.gradle 脚本控制跳过测试更灵活，支持条件判断、环境控制等高级用法。
3.1 基于条件跳过测试
可以使用 onlyIf 方法，根据条件决定是否执行测试任务。当返回 false 时，测试将被跳过。
例如，通过项目属性控制：
test.onlyIf { !project.hasProperty('skipTests') }
然后在命令行中传入属性即可跳过：
gradle build -PskipTests
输出中会显示：
> Task :test SKIPPED
✅ 这种方式适合在 CI/CD 中通过传参动态控制，比如某些环境不需要跑集成测试。
3.2 按包名或类名排除测试
你也可以在 build.gradle 中通过 exclude 配置，排除特定包或类：
test {
exclude 'org/boo/**' // 排除 org.boo 包下所有类
exclude '**/Bar.class' // 排除所有 Bar.class
}
3.3 使用正则模式排除测试
更进一步，可以通过 Ant 风格的路径模式匹配，跳过特定命名规则的测试类。
例如，跳过所有以 Integration 结尾的测试类：
test {
exclude '**/*Integration.class'
}
或者更宽松地匹配：
test {
exclude '**/**Integration'
}
⚠️ 注意：路径分隔符使用 /，且模式匹配基于编译后的 class 文件路径。
✅ 实战建议：
- 单元测试和集成测试建议分开 task，比如
test和integrationTest，这样可以更精细控制- 使用
exclude时建议配合 profile 或 property，避免硬编码
4. 总结
本文介绍了使用 Gradle 跳过测试的几种方式：
- ✅ **
-x test**：命令行最简单方式，适合本地快速跳过 - ✅
onlyIf条件判断：灵活控制，适合多环境场景 - ✅
exclude配置：按包、类、命名模式排除，适合分类管理测试
📌 最后提醒：跳过测试是把双刃剑，用得好提升效率，用不好埋下隐患。
建议仅在开发调试阶段使用，并确保最终构建和 CI 流程中始终执行完整测试套件。