Gradle中只运行单个测试类需用./gradlew test --tests "ClassName"，其中ClassName为类名（非全限定名、不带.class后缀、大小写敏感）；支持*Test等通配，匹配逻辑为后缀匹配；方法级运行格式为ClassName.methodName；测试类名须符合*Test等默认命名规则，否则需在build.gradle中配置test { include '**/*Spec.class' }。
Gradle怎么只运行单个测试类
直接用 ./gradlew test --tests "ClassName"，但必须注意类名写法和包路径——不加包名、写错大小写、或用了内部类语法都会静默跳过测试。
类名参数的三种常见写法和坑
--tests 参数支持通配，但匹配逻辑容易误判。实际生效的是「类全限定名」的后缀匹配（不是精确匹配），所以：
- ✅ 正确：运行
com.example.MyServiceTest→./gradlew test --tests "MyServiceTest" - ✅ 也行：缩小范围 →
--tests "com.example.*Test"或--tests "*MyServiceTest" - ❌ 错误：
--tests "MyServiceTest.class"（带.class后缀会被忽略） - ❌ 错误：
--tests "myserivcetest"（大小写敏感，小写不匹配） - ❌ 错误：
--tests "com.example.MyServiceTest#testSave"（方法级需额外指定，仅类名不支持 # 语法）
只想跑某个测试方法怎么办
Gradle 支持方法粒度，但必须配合类名一起写，格式是 类名.方法名：
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- ✅ 正确：
./gradlew test --tests "MyServiceTest.testSave" - ✅ 也行：
--tests "*ServiceTest.testSave"（模糊类名 + 精确方法） - ⚠️ 注意：如果测试类在子包里（如
com.example.integration.MyServiceTest），仍只需写MyServiceTest.testSave，因为匹配只看末尾；但若存在同名类（如两个MyServiceTest），就会同时触发，此时必须补全包前缀，例如--tests "com.example.unit.MyServiceTest.testSave"
为什么有时候没报错却什么都没跑
最常被忽略的是测试类未被识别为「测试」——Gradle 默认只扫描 src/test/java 下、且类名满足 *Test / Test* / *Tests 等命名规则的类。如果类名是 MyServiceTester 或 MyServiceSpec，即使放在正确目录下，--tests 也不会生效。
立即学习“Java免费学习笔记（深入）”；
- ✅ 解决办法一：重命名类（推荐）
- ✅ 解决办法二：在
build.gradle中显式配置测试包含模式：test { include '**/*Spec.class' } - ⚠️ 补充：Kotlin 项目中若用
class MyServiceTest : FunSpec()，只要文件名是MyServiceTest.kt且在src/test/kotlin，默认就能被识别
真正卡住人的往往不是命令本身，而是 Gradle 对「测试类身份」的隐式认定逻辑和 --tests 的后缀匹配机制——它不报错，只沉默跳过。
