Docker构建环境下Cypress.io如何读取.env定义的环境变量

首先明确Cypress的基础规则：默认仅识别前缀为CYPRESS_的系统环境变量，识别后会自动截去前缀，在测试代码中直接用后缀名调用即可。

以下是不同场景下的实现方法：

方法1：直接修改.env变量前缀（最简单） #

• 给.env文件中需要传入Cypress的变量加上CYPRESS_前缀，例如原变量API_URL=https://test-api.com调整为CYPRESS_API_URL=https://test-api.com
• 运行Cypress容器时通过--env-file参数加载.env文件，执行命令示例：
  docker run --env-file .env <你的Cypress镜像名> cypress run
• 测试代码中直接调用：const apiUrl = Cypress.env('API_URL')即可获取对应值。

方法2：通过docker-compose映射变量（无需修改原.env命名） #

如果不想改动原有.env的变量命名，可以在docker-compose配置中做变量映射：

• 在docker-compose.yml的Cypress服务配置中添加如下字段：

services:
  cypress:
    image: cypress/included:13.0.0 # 替换为你使用的Cypress镜像版本
    env_file: .env # 加载项目根目录的.env文件
    environment:
      # 将原.env中的变量映射为Cypress可识别的格式
      CYPRESS_API_URL: ${API_URL}
      CYPRESS_TEST_USER: ${TEST_USER}

• 运行Cypress测试命令：docker-compose run cypress cypress run
• 测试代码中同样用Cypress.env('API_URL')、Cypress.env('TEST_USER')取值即可。

方法3：容器内手动加载.env运行 #

如果是进入容器内部手动执行Cypress测试，可先加载.env文件再启动测试：

• 进入容器后先执行变量导出，示例：
  source .env && export CYPRESS_API_URL=$API_URL && cypress run

注意：敏感类环境变量（比如账号密码、接口密钥）不要明文写在.env文件中提交到代码仓库，建议通过Docker Secret或者CI/CD平台的环境变量注入功能传入。

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