Cypress 13兼容的@badeball/cypress-cucumber-preprocessor版本及类型问题排查

兼容版本匹配 #

Cypress 13.x 对应的 @badeball/cypress-cucumber-preprocessor 最低兼容版本是 ^20.0.0，你当前使用的 19.2.0 版本不支持 Cypress 13，这是核心问题之一。

类型不匹配错误修复 #

你遇到的 esbuild Plugin 类型冲突，是不同依赖包引入的 esbuild 类型定义路径不一致导致的，按以下步骤修复：

• 升级 @badeball/cypress-cucumber-preprocessor 到 ^20.0.0 及以上版本
• 同步升级 @bahmutov/cypress-esbuild-preprocessor 到适配版本，建议保留 ^2.2.0 及以上（和你当前版本兼容，但需确保与新的 cucumber 处理器匹配）
• 在 cypress.config.ts 中统一类型导入，避免从不同路径引入：

  import type { Plugin } from "esbuild";
  

  确保所有用到 esbuild Plugin 的地方都使用这个统一的类型。

兼容性文档位置 #

@badeball/cypress-cucumber-preprocessor 的兼容性说明直接在项目的 README 中，会专门列出对应 Cypress 版本的兼容处理器版本范围；另外也可以查看项目的 CHANGELOG，里面会标注每个版本适配的 Cypress 版本。

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