本文详解 cucumber 7.x 中使用 @cucumberoptions.tags 运行多标签的语法规则，重点澄清 and 与 or 的逻辑差异、常见误用场景及解决方案，并提供可直接复用的配置示例。
在 Cucumber Java 项目中，通过标签（Tags）对测试用例进行分类和按需执行是核心实践之一。但许多开发者在尝试同时运行多个标签时遇到“无测试执行、进程静默退出（exit code 0）”的问题——这并非环境或版本故障，而是标签表达式逻辑被误解所致。
✅ 正确理解 tags 表达式的布尔逻辑
Cucumber 的 tags 属性接受 Gherkin 标签表达式（Tag Expression），其语法遵循严格的布尔逻辑：
- @PW and @WM：表示单个 Feature 或 Scenario 必须同时标注 @PW 和 @WM 两个标签（交集）。若没有任何 .feature 文件同时包含这两个标签，则不执行任何测试，控制台无报错但显示 0 tests executed。
- @PW or @WM：表示只要 Feature 或 Scenario 标注了 @PW 或 @WM 中的任意一个（并集），即被纳入执行范围。这是跨多个业务模块/测试类型批量执行的常用方式。
? 示例验证： features/login.feature 含 @PW features/dashboard.feature 含 @WM → 使用 tags = "@PW or @WM" 可同时运行二者；而 tags = "@PW and @WM" 将匹配失败，导致零执行。
✅ 推荐的 Runner 类配置（Cucumber 7.9.0 + JUnit 4）
import org.junit.runner.RunWith;
import io.cucumber.junit.Cucumber;
import io.cucumber.junit.CucumberOptions;
@RunWith(Cucumber.class)
@CucumberOptions(
features = "src/test/resources",
glue = "stepdefs", // ⚠️ 注意：glue 应指向 step definition 包路径（如 "stepdefs"），而非 "/"（该写法会导致绑定失败）
plugin = {
"pretty",
"html:target/cucumber-reports.html",
"json:target/cucumber.json",
"junit:target/junit-cucumber-reports/Cucumber-junit.xml",
"com.aventstack.extentreports.cucumber.adapter.ExtentCucumberAdapter:"
},
tags = "@PW or @WM" // ✅ 正确：运行任一标签的场景
// tags = "@smoke and @regression" // ✅ 仅当同一场景同时有两标签时才生效
)
public class TestRunner {
}⚠️ 关键注意事项
- glue 参数必须为合法包路径：glue = {"/"} 是无效写法，会导致步骤定义无法绑定，建议明确指定如 "stepdefs" 或 "com.example.steps"。
- 空格与大小写敏感：@PW 和 @pw 被视为不同标签；"@PW or@WM"（缺少空格）将解析失败。
-
支持嵌套逻辑：可组合更复杂表达式，例如：
tags = "(@smoke or @regression) and not @wip" -
Maven 命令行覆盖（推荐用于 CI/CD）：
mvn test -Dcucumber.filter.tags="@PW or @WM"
此方式优先级高于 @CucumberOptions，便于灵活调度。
✅ 总结
| 场景 | 表达式写法 | 语义 |
|---|---|---|
| 运行属于任一分类的测试 | @tag1 or @tag2 | 并集（最常用） |
| 运行同时满足多条件的测试 | @tag1 and @tag2 | 交集（需同一场景含全部标签） |
| 排除某类测试 | not @ignored | 差集 |
务必根据实际标签分布选择逻辑运算符——多数“多标签运行”需求本质是 or，而非直觉上的 and。调试时可通过 --dry-run 模式（添加 dryRun = true 到 @CucumberOptions）快速验证哪些场景会被匹配，避免盲目修改配置。
