Gradle通过--tests "包名.类名#方法名"运行单个JUnit 5测试方法，必须使用全限定名且配置useJUnitPlatform()，-Dtest.single已弃用。
Gradle怎么运行单个JUnit 5测试方法
Gradle本身不直接支持“只跑某个测试类里的某个方法”这种细粒度控制，但通过--tests参数配合完整方法签名，可以精准命中。关键在于写对测试路径格式，否则会静默跳过或报错。
常见错误现象：test任务执行后显示“0 tests completed”，其实是因为--tests值没匹配上任何方法——不是Gradle没生效，是匹配规则没写对。
- JUnit 5必须用全限定名：包名 + 类名 + # + 方法名，例如
--tests "com.example.MyTest#testValidInput" - 类名不能省略，也不能写成
MyTest.testValidInput（点号是分隔符，不是Java语法） - 如果方法名含参数（如重载），Gradle不区分签名，只认方法名；多个同名方法会全部执行
- 确保
test任务未被跳过：检查是否误加了--no-build-cache之类干扰参数，或test.enabled = false在build.gradle里
为什么用--tests而不是-Dtest.single
-Dtest.single是Gradle 4.x及更早版本对JUnit 4的旧支持方式，从Gradle 5开始已被弃用，且对JUnit 5完全无效。现在统一走--tests，它底层调用的是JUnit Platform的ClassNameFilter和MethodNameFilter，兼容JUnit 4/5/TestNG。
容易踩的坑：-Dtest.single=MyTest看起来能跑整个类，但实际可能因类路径问题漏加载依赖，或与useJUnitPlatform()配置冲突；而--tests是声明式过滤，由测试引擎原生处理，更可靠。
- 正确写法：
./gradlew test --tests "com.example.MyTest#testValidInput" - 错误写法：
./gradlew test -Dtest.single=MyTest#testValidInput（会被忽略） - 注意空格：
--tests和值之间必须有空格，且值建议用英文双引号包裹，防shell解析出错
IDE里点运行和命令行结果不一致？
IntelliJ或VS Code执行单个测试方法时，实际启动的是自己的测试代理进程，会自动注入classpath、VM参数和JUnit Platform配置，还可能启用测试探测（test discovery）。而Gradle命令行严格按build.gradle中定义的test任务行为执行——比如你忘了在test块里写useJUnitPlatform()，命令行就根本不会识别JUnit 5的@Test注解。
- 检查
build.gradle是否包含：test { useJUnitPlatform() } - 确认
dependencies里引入了org.junit.jupiter:junit-jupiter，而非仅junit:junit（后者是JUnit 4） - 如果项目用了
testImplementation 'org.junit.jupiter:junit-jupiter:5.10.2'，但Gradle缓存了旧版本，可加--refresh-dependencies重拉
想跳过编译直接跑测试？别这么做
有人试过./gradlew test --tests "X#y" --no-daemon --offline想提速，但Gradle的test任务默认依赖compileTestJava，跳过编译会导致NoClassDefFoundError或ClassNotFoundException。这不是bug，是设计使然：测试代码也是代码，必须先编译才能执行。
真正有效的加速方式只有两个：
- 确保
test任务输入稳定，利用Gradle构建缓存（buildScan或configuration-cache） - 用
--continue避免因其他模块失败中断，但不跳过编译步骤
最常被忽略的一点：如果你的测试方法用了@Disabled或条件化启用（如@EnabledOnOs(OS.WINDOWS)），--tests照样会匹配到它，但最终不会执行——得看控制台输出的“skipped”提示，而不是只盯“completed”计数。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
