Java 中 JUnit 怎么使用 @Tag 和 @IncludeTags 实现测试用例的分组与定向过滤运行-java教程-PHP中文网

JUnit 5 通过 @Tag 注解实现测试分类，配合构建工具（如 Maven Surefire、Gradle）或 IDE 的标签过滤功能可定向执行测试；@Tag 用于标记类或方法，标签名需符合 Java 标识符规范且大小写敏感。

java 中 junit 怎么使用 @tag 和 @includetags 实现测试用例的分组与定向过滤运行

JUnit 5 提供了基于标签（@Tag）的测试分类机制，配合 @IncludeTags（实际是构建工具或运行时配置中的过滤参数）可实现灵活的分组与定向执行。注意：@IncludeTags 并非 JUnit 内置注解，而是 Maven Surefire / Gradle Test 等插件支持的运行时过滤选项；真正用于标记测试的是 @Tag，而筛选逻辑由测试运行器或构建工具完成。

用 @Tag 给测试方法或类打标签

@Tag 是 JUnit 5 的标准注解，可用于类或方法级别，支持字符串值（不能含空格、逗号、冒号等特殊字符）。多个标签可用多个 @Tag 注解叠加。

给单个测试方法加标签：

@Test
@Tag("smoke")
@Tag("api")
void shouldCreateUser() {
    // ...
}

给整个测试类加标签（该类下所有 @Test 方法默认继承这些标签）：

@Tag("integration")
class UserServiceIntegrationTest {
    @Test
    void shouldLoadUserById() { /* ... */ }
<pre class="brush:php;toolbar:false;">@Test
@Tag("slow") // 可覆盖/补充类级标签
void shouldSyncWithExternalService() { /* ... */ }

}

在 Maven 中按标签过滤运行（使用 surefire 插件）

Maven Surefire 插件通过 <includes></includes> 或更常用的是 <groups></groups> 参数支持标签过滤（对应 JUnit 的 @Tag），实际生效的是 groups 配置项。

只运行带 smoke 标签的测试：

<plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-surefire-plugin</artifactid><version>3.2.5</version><configuration><groups>smoke</groups></configuration></plugin>

运行多个标签（逻辑 OR）：

<groups>smoke,integration</groups>

排除某类标签（需配合 <excludes></excludes> 或使用 !tag 语法，取决于 Surefire 版本；推荐用 groups + excludedGroups）：

<groups>api</groups><excludedgroups>slow</excludedgroups>

在 Gradle 中按标签过滤运行

Gradle 的 test 任务原生支持 includeTags 和 excludeTags 属性（自 Gradle 4.6+，JUnit Platform 集成后）。

命令行只运行 smoke 标签的测试：

./gradlew test --tests "*smoke*"

更规范的方式是在 build.gradle 中配置：

maven-dependency-management

管理Maven 依赖、解决依赖冲突、配置 BOM 或优化 Java 项目依赖树。

下载

test {
    useJUnitPlatform {
        includeTags = ["smoke", "api"]
        excludeTags = ["slow"]
    }
}

运行时动态指定（推荐 CI 场景）：

./gradlew test -Dtags=smoke

再配合 systemProperty 读取并设置：

test {
    systemProperty "junit.platform.tags", System.getProperty("tags", "")
    useJUnitPlatform()
}

IDE 中运行指定标签的测试（IntelliJ IDEA 示例）

IntelliJ 原生支持 JUnit 5 标签过滤：

右键点击测试类或方法 → Run 'xxx' with Coverage → 在弹出窗口中点击齿轮图标 → Modify Options → Tags → 输入 smoke 或 api
也可直接在运行配置的 VM Options 中添加：-Djunit.platform.tags=smoke
编辑运行配置时，勾选 JUnit Platform，并在 Tags 输入框填写标签名（支持逗号分隔）