WebdriverIO+Cucumber清理未用步骤定义：cucumber-js命令报错求助

一、修复cucumber-js命令的"No step definitions"问题 #

直接执行cucumber-js命令时，它无法读取WebdriverIO配置文件中定义的步骤路径，需要显式指定步骤定义的位置：

cucumber-js --dry-run --format usage --require ./test/step-definitions/**/*.js

• 将./test/step-definitions/**/*.js替换为你项目中步骤定义文件的实际路径，支持通配符匹配所有相关文件。
• 若步骤定义依赖WebdriverIO全局变量（如browser），直接用cucumber-js可能报错，建议改用WebdriverIO的方式执行。

二、通过WebdriverIO配置执行Dry Run #

在你的wdio.conf.js中修改cucumberOpts配置：

cucumberOpts: {
    // 保留原有配置
    dryRun: true,
    format: ['usage']
}

然后运行WebdriverIO命令：

npx wdio run wdio.conf.js

该方式会自动读取配置中的步骤定义路径，执行Dry Run并输出未使用的步骤信息。

三、其他工具/插件方案 #

• eslint-plugin-cucumber：集成到ESLint中，开启no-unused-step-definitions规则可实时检测未使用的步骤定义。在.eslintrc.js中配置：

  module.exports = {
      plugins: ['cucumber'],
      rules: {
          'cucumber/no-unused-step-definitions': 'error'
      }
  }
  

• cucumber-steps-usage：专门分析Cucumber步骤使用情况的工具，安装后通过指定特征文件和步骤路径生成报告：

  npx cucumber-steps-usage --features ./test/features/**/*.feature --steps ./test/step-definitions/**/*.js
  

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