本文介绍如何在 cucumber-jvm 中避免在步骤定义中错误绑定参数（如误将 `scenario` 对象当作步骤参数），转而使用官方推荐的 `@cucumberoptions(name = "...")` 机制，结合正则表达式（如负向先行断言）实现对特定名称场景的优雅跳过。
在 Cucumber 中，步骤定义方法的参数必须严格对应正则表达式捕获组——Scenario 对象不是由正则匹配传入的，而是由 Cucumber 框架自动注入的“上下文对象”，它不能也不应出现在 @Given、@When 或 @Then 标注的方法签名中作为参数（除非使用 Cucumber 7+ 的 StepDefinition API 配合 StepDefinitionContext，但这是高级用法且不适用于 @BeforeStep）。您原始代码中的问题在于：
@Given("^skip the next scenario named \"(.*)\"$")
@BeforeStep
public void before(Scenario scenario, String name) { // ❌ 错误：@Given 方法无法接收 Scenario 参数
// ...
}该写法会导致运行时绑定失败或 NullPointerException，因为 Cucumber 不会将 Scenario 注入到 @Given 步骤方法中——Scenario 仅可用于 @Before、@After、@BeforeStep、@AfterStep 等钩子（Hook）方法，且钩子方法不支持正则参数捕获。
✅ 正确解法：放弃在步骤中“动态跳过”，改用 Cucumber 启动时的声明式过滤。
Cucumber-JVM（特别是与 JUnit 4/5 集成时）提供了强大的 @CucumberOptions，其中 name 属性支持 Java 正则表达式，可精确匹配（或排除）场景名称。例如，要跳过名为 "Addition" 的场景，但保留 "Another Addition"，可使用负向先行断言（negative lookahead）：
package io.cucumber.examples.calculator;
import io.cucumber.junit.Cucumber;
import io.cucumber.junit.CucumberOptions;
import org.junit.runner.RunWith;
@RunWith(Cucumber.class)
@CucumberOptions(
features = "src/test/resources/features", // 指定 feature 路径（按需调整）
name = "^(?!Addition$).*$" // ✅ 匹配所有不以 "Addition" 为完整名称的场景
)
public class RunCucumberTest {
}? 正则说明：
- ^：行首
- (?!Addition$)：负向先行断言，要求当前位置之后不能紧跟着 "Addition" 并以 $ 结束（即整个场景名不能等于 "Addition"）
- .*$：匹配任意字符直到行尾
⚠️ 注意事项：
- name 过滤的是 Scenario 名称（即 Scenario: xxx 后的文本），不包含 Feature 或 Background；
- 若需跳过多个名称（如 "Addition" 和 "Division"），可扩展为：name = "^(?!Addition$|Division$).*$"；
- 该方式在测试执行前生效，属于静态过滤，性能优于运行时 Assume.assumeTrue(false) 强制跳过（后者仍会初始化步骤、执行钩子，造成冗余开销）；
- @BeforeStep 中无法访问正则捕获的 name，因其设计目的仅为拦截步骤执行上下文，而非解析 Gherkin 文本。
? 总结：Cucumber 的最佳实践是「配置优先于编码」。与其在步骤或钩子中用脆弱的字符串比较 + Assume 临时跳过，不如利用 @CucumberOptions.name 进行精准、可读、可维护的场景筛选。这既符合框架设计哲学，也提升了测试套件的健壮性与可调试性。
