如何在VS Code中运行Java Cucumber Web自动化项目的.feature文件？

1. 先确认必备插件已安装 #

• 安装Cucumber (Gherkin) Full Support：提供.feature文件的语法高亮、步骤关联提示
• 安装Extension Pack for Java：搞定Java项目的基础依赖、编译、导入等核心功能
• 安装Test Runner for Java：支持Java测试用例的运行与调试

2. 检查项目依赖配置 #

确保项目的pom.xml（Maven）或build.gradle（Gradle）里正确引入了Cucumber相关依赖，以下是Maven的示例片段：

<dependencies>
    <!-- Cucumber Java核心依赖 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-java</artifactId>
        <version>7.14.0</version>
        <scope>test</scope>
    </dependency>
    <!-- Cucumber与JUnit集成依赖 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-junit</artifactId>
        <version>7.14.0</version>
        <scope>test</scope>
    </dependency>
    <!-- JUnit测试框架 -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.13.2</version>
        <scope>test</scope>
    </dependency>
</dependencies>

3. 创建Cucumber运行类 #

在src/test/java目录下新建一个运行配置类，指定.feature文件路径和步骤定义的包路径，示例：

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

@RunWith(Cucumber.class)
@CucumberOptions(
    features = "src/test/resources/features", // 替换成你项目中.feature文件的实际路径
    glue = "com.yourproject.stepdefs", // 替换成步骤定义类所在的包名
    plugin = {"pretty", "html:target/cucumber-report.html"} // 可选：配置测试报告输出
)
public class CucumberTestRunner {
}

4. 两种运行.feature文件的方法 #

方法一：通过运行类批量执行 #

找到你创建的CucumberTestRunner类，右键选择Run，或者点击代码左侧的运行按钮，就能触发所有关联的.feature文件执行。

方法二：直接运行单个.feature文件 #

打开目标.feature文件，在文件顶部或每个场景的左侧会出现运行按钮（需Cucumber插件正常工作），点击即可单独运行该文件或某个特定场景。如果看不到按钮，检查插件是否安装到位，以及步骤定义类的注解（如@Given、@When）是否与.feature里的文本完全匹配。

5. 常见问题排查 #

• 测试面板无反应：检查VS Code左下角的Java项目图标是否正常（无红色报错），确保Java项目已正确导入。
• 步骤定义未关联：核对CucumberOptions里的glue路径是否正确，步骤定义方法的注解文本是否和.feature里的步骤完全一致（包括空格、大小写）。
• 环境问题：通过Ctrl+Shift+P打开命令面板，输入Java: Configure Java Runtime，确认JDK路径配置正确。

内容的提问来源于stack exchange，提问作者Pauline-momanyi