如何为Jest传递自定义参数以切换测试环境？

架构老林

2026-5-22

当然可行！这里有几种简单的实现方案

你的需求完全可以实现，而且不用自己手动解析命令行参数（毕竟Jest本身有现成的机制可以利用），下面给你推荐两种最常用的方案：

方案一：环境变量 + Jest全局变量注入（最简洁）

这种方式不用修改Jest的默认参数逻辑，靠系统环境变量传递环境标识，步骤如下：

运行测试时传递环境变量：

# Mac/Linux
TEST_ENV=local jest

# Windows cmd
set TEST_ENV=local && jest

# Windows PowerShell
$env:TEST_ENV='local'; jest

在jest.config.js里配置全局变量，把环境变量注入到测试上下文：

module.exports = {
  // 其他配置...
  globals: {
    TEST_ENV: process.env.TEST_ENV || 'local' // 设置默认环境为local
  }
};

在测试文件里统一管理环境URL映射，直接使用全局变量：

// 可以把这段抽成单独的配置文件，比如config/testUrls.js
const testUrls = {
  local: 'http://localhost:3000',
  dev: 'https://dev.yourdomain.com',
  qa: 'https://qa.yourdomain.com'
};

// 测试用例里直接用
const baseUrl = testUrls[global.TEST_ENV];

test('测试接口请求', async () => {
  const response = await fetch(`${baseUrl}/api/data`);
  // ...测试逻辑
});

方案二：自定义命令行参数（如果坚持用`--env`风格）

注意：Jest自带的--env参数是用来指定测试运行环境（比如node、jsdom），直接用会冲突，所以我们可以自定义参数，比如--test-env：

先安装yargs-parser用来解析命令行参数（如果没装的话）：
```
npm install yargs-parser --save-dev
```

在jest.config.js里解析参数并注入全局变量：

const argv = require('yargs-parser')(process.argv.slice(2));
const testEnv = argv['test-env'] || 'local';

module.exports = {
  // 其他配置...
  globals: {
    TEST_ENV: testEnv
  }
};