从头搭建Cypress项目时feature文件无法识别步骤定义求助

核心问题与修复步骤 #

1. Cypress 10+ 插件配置未生效 #

你当前的cypress.config.js中setupNodeEvents方法是空的，没有加载cucumber预处理器。Cypress 10+ 已废弃单独的index.js插件文件，所有节点事件配置必须整合到cypress.config.js中。

修改后的cypress.config.js：

const { defineConfig } = require("cypress");
const cucumber = require('@badeball/cypress-cucumber-preprocessor').default;

module.exports = defineConfig({
  e2e: {
    specPattern: 'cypress/integration/features/*.feature',
    setupNodeEvents(on, config) {
      on('file:preprocessor', cucumber(config)); // 必须传入config参数
    },
  },
});

2. package.json 配置字段错误 #

@badeball/cypress-cucumber-preprocessor的配置字段不需要带@badeball前缀，需调整为标准字段名：

修改后的package.json相关部分：

{
  // ...其他内容
  "cypress-cucumber-preprocessor": {
    "nonGlobalStepDefinitions": false,
    "stepDefinitions": "cypress/integration/features/stepDefs"
  }
}

3. 依赖版本不兼容 #

你安装的cucumber@6.0.7版本过旧，与@badeball/cypress-cucumber-preprocessor@15.x不兼容。执行以下命令替换为官方新版依赖：

npm uninstall cucumber
npm install --save-dev @cucumber/cucumber

4. 步骤定义文件规范检查 #

确保步骤定义文件（如cypress/integration/features/stepDefs/loginSteps.js）格式正确，示例：

const { Given, When, Then } = require('@badeball/cypress-cucumber-preprocessor');

Given('我打开登录页面', () => {
  cy.visit('/login');
});

5. 清理缓存重启Cypress #

修改配置后，删除node_modules/.cache目录，再重启Cypress，避免缓存导致配置不生效。

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