无需修改build.gradle，能否通过Gradle CLI执行指定Tags/注解的JUnit测试？

当然可以做到，Gradle虽然没有直接的--include-tags命令行参数，但通过系统属性+初始化脚本的组合，就能实现完全不用修改项目构建文件，只靠命令行跑指定Tag或注解的测试。

核心实现思路 #

利用Gradle的初始化脚本（init script）全局配置测试任务，同时通过命令行传递系统属性来指定要执行的Tag，完全不需要改动项目本地的build.gradle文件。

具体操作步骤 #

1. 通过命令行传递Tag参数
   用-D参数定义自定义系统属性，比如要跑标记了SmokeTest或IntegrationTest的测试：

   ./gradlew test -Dtest.include.tags="SmokeTest,IntegrationTest"
   

2. 用初始化脚本动态配置测试任务
   初始化脚本可以全局修改所有项目的测试任务配置，你有两种方式使用它：

   • 方式一：单独创建初始化脚本文件
     新建init.gradle文件，内容如下：

     allprojects {
         tasks.withType(Test) {
             // 启用JUnit 5平台（必须，因为Tag是JUnit 5特性）
             useJUnitPlatform()
             // 读取命令行传入的Tag参数，配置测试任务只执行这些Tag的用例
             if (System.getProperty('test.include.tags')) {
                 includeTags System.getProperty('test.include.tags')
             }
         }
     }
     

     然后命令行指定使用这个脚本：

     ./gradlew test -Dtest.include.tags="SmokeTest" -I init.gradle
     

   • 方式二：直接在命令行传递脚本内容（适合流水线环境）
     不用单独存文件，把脚本内容通过系统属性传递，更适合流水线模板的场景：

     ./gradlew test -Dtest.include.tags="SmokeTest" -Dorg.gradle.init.script="""
     allprojects {
         tasks.withType(Test) {
             useJUnitPlatform()
             if (System.getProperty('test.include.tags')) {
                 includeTags System.getProperty('test.include.tags')
             }
         }
     }
     """
     

针对自定义注解的适配 #

如果你的自定义注解（比如@SmokeTest）已经添加了JUnit的@Tag("SmokeTest")元注解，那上面的方案直接生效——JUnit平台会自动识别注解上绑定的Tag，只要命令行指定对应的Tag名称即可，不需要额外调整。

注意事项 #

• 确保项目使用JUnit 5（JUnit Platform），Tag是JUnit 5的特性，必须通过useJUnitPlatform()启用。如果项目还在使用JUnit 4，可以改用JUnit 4的Category分类功能，逻辑类似：把includeTags换成includeCategories，命令行传递分类类名即可。
• 初始化脚本的配置是全局生效的，会作用于项目中所有的Test类型任务，符合流水线模板的需求。

内容的提问来源于stack exchange，提问作者Tim Vahlbrock