Cypress 10.0.0如何实现多配置文件支持多环境E2E测试？

Cypress 10.0 版本并未完全移除多配置切换能力，只是调整了相关API和CLI参数规则，以下3种方案均可实现和旧版configFile传参同等的多环境切换效果，可根据自身项目场景选择：

方案1：沿用多独立配置文件模式（最贴近旧版使用习惯） #

旧版驼峰写法的configFile参数在10.0后更名为烤串命名的--config-file，完全可以保留之前为每个环境单独建配置文件的习惯：

• 为不同环境创建独立配置文件，比如cypress.config.dev.js、cypress.config.staging.js、cypress.config.prod.js，每个文件内写对应环境的全量配置
• CLI运行时通过--config-file指定目标环境配置即可

# 运行staging环境测试
npx cypress run --config-file cypress.config.staging.js

这个方案的优势是不同环境配置完全隔离，不会出现配置互相覆盖的问题，适合环境差异较大的项目。

方案2：单配置文件+动态逻辑分支（轻量化方案，适合环境差异小的项目） #

只保留一个默认的cypress.config.js，在配置内提前定义各环境的差异化配置，根据CLI传入的环境标识动态合并配置：

// cypress.config.js
const { defineConfig } = require("cypress");
// 各环境差异化配置
const envConfigs = {
  dev: {
    baseUrl: "http://localhost:8080",
    env: { apiUrl: "http://localhost:3000/api" }
  },
  staging: {
    baseUrl: "https://staging.example.com",
    env: { apiUrl: "https://staging.example.com/api" }
  },
  prod: {
    baseUrl: "https://example.com",
    env: { apiUrl: "https://example.com/api" }
  }
}

module.exports = defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      const targetEnv = config.env.targetEnv || 'dev'
      return { ...config, ...envConfigs[targetEnv] }
    },
    // 所有环境通用的公共配置统一维护
    specPattern: "cypress/e2e/**/*.cy.{js,ts}",
    supportFile: "cypress/support/e2e.js",
    defaultCommandTimeout: 8000
  }
})

CLI调用时传入环境标识即可：

# 运行生产环境冒烟测试
npx cypress run --env targetEnv=prod --spec cypress/e2e/smoke/**/*.cy.js

公共配置项只需要写一次，不用在每个环境配置文件里重复维护。

方案3：系统环境变量注入（适合CI/CD场景） #

Cypress会自动识别所有以CYPRESS_开头的系统环境变量，自动覆盖对应配置项，不需要在代码仓库里硬编码各环境配置：

# 注入staging环境配置并运行测试（类Unix系统）
export CYPRESS_BASE_URL=https://staging.example.com
export CYPRESS_env_apiUrl=https://staging.example.com/api
npx cypress run

这个方案适合存放生产环境等敏感场景的配置，不需要把账号、密钥等信息提交到代码库。

Cypress配置优先级从高到低为：CLI直接传参 > CYPRESS_开头的系统环境变量 > 配置文件内定义的默认值，多方案混用时注意优先级顺序，避免配置不符合预期。升级后原有测试用例里的Cypress.config()、Cypress.env()调用逻辑不需要修改，完全向前兼容。

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