如何让Cypress Cucumber完全忽略不匹配标签的测试以提速？

以下几种方法可以让Cypress完全忽略不匹配标签的测试，避免不必要的遍历和资源消耗：

1. 开启预处理器的filterSpecs配置 #

这是最直接有效的方案，通过@badeball/cypress-cucumber-preprocessor的内置配置，在测试加载阶段就过滤掉不匹配标签的场景，而不是等到运行时标记为pending。

在你的cypress.config.js中添加以下配置：

const { defineConfig } = require('cypress');
const createBundler = require('@bahmutov/cypress-esbuild-preprocessor');
const { addCucumberPreprocessorPlugin } = require('@badeball/cypress-cucumber-preprocessor');
const createEsbuildPlugin = require('@badeball/cypress-cucumber-preprocessor/esbuild');

module.exports = defineConfig({
  e2e: {
    async setupNodeEvents(on, config) {
      const bundler = createBundler({
        plugins: [createEsbuildPlugin(config)],
      });

      on('file:preprocessor', bundler);
      await addCucumberPreprocessorPlugin(on, config);

      // 核心配置：开启spec过滤，提前排除不匹配标签的内容
      config.env.filterSpecs = true;
      return config;
    },
    specPattern: 'cypress/e2e/**/*.feature',
  },
});

配置生效后，Cypress会在加载feature文件时就筛选出符合标签的场景，不会再处理不匹配的内容，直接跳过遍历步骤。

2. 确保使用最新版的Cucumber预处理器 #

旧版本的cypress-cucumber-preprocessor（比如非@badeball开头的包）可能没有filterSpecs功能，建议升级到当前主流的稳定版本：

npm update @badeball/cypress-cucumber-preprocessor @bahmutov/cypress-esbuild-preprocessor

3. 结合--spec参数缩小扫描范围（可选） #

如果你的测试文件有明确的目录划分（比如冒烟测试单独放在smoke目录），可以直接用--spec参数指定要扫描的文件，进一步减少预处理器的工作量：

npx cypress run --browser chrome --env 'TAGS=@quicktest' --spec 'cypress/e2e/smoke/**/*.feature'

效果验证 #

配置完成后重新运行测试，你会发现测试总数只显示匹配标签的数量，不再有大量pending测试，CPU占用会恢复正常，测试时长也会缩短到实际运行测试的时间，视频也只会录制真正执行的测试过程。

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