Cypress 10+Cucumber项目步骤定义存放位置与依赖图遍历错误排查

1. 核心配置修正（解决依赖图错误） #

你遇到的Can't walk dependency graph错误，是因为Cypress 10默认不会自动扫描e2e子目录下的步骤定义文件，仅修改specPattern不够，需要同时配置步骤定义的扫描路径。

在cypress.config.ts的e2e配置块中，添加stepDefinitions字段，完整配置示例：

import { defineConfig } from 'cypress'

export default defineConfig({
  e2e: {
    // 指定feature文件的扫描路径
    specPattern: 'cypress/e2e/features/**/*.feature',
    // 指定步骤定义文件的扫描路径
    stepDefinitions: 'cypress/e2e/step definitions/**/*.ts',
    // 其他原有配置（如baseUrl等）保持不变
  },
})

• specPattern：告诉Cypress去哪里查找.feature测试文件，**表示递归扫描子目录
• stepDefinitions：明确步骤定义文件的位置，让Cypress能关联feature文件中的步骤

2. package.json 是否需要修改？ #

不需要额外修改，除非你的启动命令硬编码了旧的文件路径（比如cypress run --spec "cypress/e2e/*.feature"）。如果是这种情况，只需把--spec后的路径更新为cypress/e2e/features/**/*.feature即可，默认的cypress run或cypress open命令无需调整。

3. 目录结构的最佳实践 #

你想要的分离式目录结构是推荐的最佳实践，尤其适合测试用例较多的项目：

e2e
  features
      example.feature
      example2.feature
  step definitions
      example.ts
      example2.ts

这种结构能清晰区分测试用例（feature）和实现逻辑（步骤定义），便于团队协作和维护，完全符合Cypress 10的自定义目录设计理念。

另外需要注意：如果步骤定义文件中有相对路径的导入（比如导入公共工具函数），要同步调整导入路径，避免出现文件找不到的问题。

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