如何在IntelliJ IDEA的TestRunner运行配置中正确传递Cucumber标签？

匹配Cucumber版本调整VM参数格式 #

不同版本的Cucumber对VM参数的要求不同，这是最常见的问题根源：

• Cucumber 6.x及以上版本：废弃了cucumber.options参数，改用cucumber.filter.tags，VM选项应写为：

  -Dcucumber.filter.tags="@example"
  

• Cucumber 5.x及以下版本：保留cucumber.options，但需去掉参数外的引号（不同IDE对引号解析逻辑有差异），改为：

  -Dcucumber.options=--tags @example
  

确保TestRunner类无标签硬编码 #

检查你的TestRunner类，确保@CucumberOptions中没有设置tags属性，避免覆盖VM参数传递的标签。示例正确结构：

import org.junit.runner.RunWith;
import io.cucumber.junit.Cucumber;
import io.cucumber.junit.CucumberOptions;

@RunWith(Cucumber.class)
@CucumberOptions(
    features = "src/test/resources/features",
    glue = "com.yourpackage.stepdefinitions"
    // 此处不要添加tags配置
)
public class TestRunner {
}

IDE运行配置细节调整 #

• IntelliJ IDEA：在「运行/调试配置」的「VM选项」中直接填入参数，无需额外引号包裹。
• Eclipse：同样在VM参数栏中去掉引号，避免IDE解析时截断参数。

验证参数是否正确传入 #

可以在TestRunner类中添加静态代码块，打印系统参数确认是否读取成功：

public class TestRunner {
    static {
        // 高版本Cucumber用下面的打印语句
        System.out.println("传入的Cucumber标签：" + System.getProperty("cucumber.filter.tags"));
        // 低版本替换为：System.getProperty("cucumber.options")
    }
}

运行时查看控制台输出，确认参数是否正确传递。

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