VSCode执行全部JUnit测试而非仅标记测试的问题排查

问题说明 #

配置JUnit标签过滤规则后，VSCode仍会运行所有单元测试。当前配置与测试代码如下：

错误配置（settings.json） #

"java.test.Config": {
    "name": "default",
    "workingDirectory": "${workspaceFolder}",
    "testKind": "junit",
    "filters.tags": [
        "group2",
    ]
}

测试代码 #

import static org.junit.jupiter.api.Assertions.assertEquals;
import org.junit.jupiter.api.Tag;
import org.junit.jupiter.api.Test;

public class DemoTest {
  @Test
  @Tag("group1")
  void test1() {
    assertEquals(1, 1);
  }

  @Test
  @Tag("group2")
  void test2() {
    assertEquals(2, 2);
  }

  @Test
  @Tag("group2")
  void test3() {
    assertEquals(3, 3);
  }
}

解决步骤 #

• 修正配置文件格式
  Test Runner for Java的正确配置键为java.test.configurations（复数、小写），且filters需以对象形式定义，而非点分隔的键名。修改settings.json内容如下：

  "java.test.configurations": [
      {
          "name": "仅运行group2",
          "workingDirectory": "${workspaceFolder}",
          "testKind": "junit",
          "filters": {
              "tags": ["group2"]
          }
      }
  ]
  

• 切换到目标测试配置
  打开VSCode测试面板，点击顶部的配置下拉菜单（默认显示"Default Configuration"），选择你定义的仅运行group2配置，再执行测试即可只运行带有group2标签的用例。

• 确认JUnit版本适配
  @Tag是JUnit 5（Jupiter）的专属特性，确保项目依赖的是JUnit 5而非JUnit 4。以Maven为例，pom.xml需包含以下依赖：

  <dependency>
      <groupId>org.junit.jupiter</groupId>
      <artifactId>junit-jupiter-api</artifactId>
      <version>5.9.2</version>
      <scope>test</scope>
  </dependency>
  <dependency>
      <groupId>org.junit.jupiter</groupId>
      <artifactId>junit-jupiter-engine</artifactId>
      <version>5.9.2</version>
      <scope>test</scope>
  </dependency>
  

• 检查注解导入正确性
  测试类中必须导入JUnit 5的@Tag注解：

  import org.junit.jupiter.api.Tag;
  

  避免导入其他版本的同名注解导致失效。

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