如何让Jest全局自动Mock模块，无需在所有测试文件中重复配置？

当然可以！Jest有几种简单的方式帮你实现全局自动Mock指定模块，再也不用在每个测试文件里重复写jest.mock语句了。针对你的场景，我给你整理了两种最实用的方案：

方案一：通过全局Setup文件自动执行jest.mock #

这是最贴合Jest原生Mock机制的方案，本质是在所有测试文件运行前，全局执行一次jest.mock来指定Mock模块。

步骤： #

1. 创建全局测试初始化文件，比如在src目录下新建setupTests.js：

   // src/setupTests.js
   // 注意路径要和你的项目结构匹配，确保能正确指向src/config.js
   jest.mock('./config');
   

2. 在Jest配置文件中（比如jest.config.js或者package.json的jest字段），指定这个初始化文件：
   • 如果用jest.config.js：

     module.exports = {
       // 其他Jest配置...
       setupFilesAfterEnv: ['<rootDir>/src/setupTests.js'],
     };
     

   • 如果用package.json：

     {
       "jest": {
         "setupFilesAfterEnv": ["<rootDir>/src/setupTests.js"]
       }
     }
     

这样配置后，所有测试文件在运行前都会自动执行jest.mock('./config')，直接使用你在src/__mocks__/config.js中定义的Mock内容，完全不用在单个测试文件里重复写Mock语句。

方案二：利用moduleNameMapper重定向模块导入 #

这种方式是直接把所有对config模块的导入请求，重定向到你的Mock文件，相当于从导入层面替换了原模块。

配置方式： #

在jest.config.js中添加moduleNameMapper规则：

module.exports = {
  // 其他Jest配置...
  moduleNameMapper: {
    // 用正则匹配所有导入config的路径，替换为Mock文件
    '^.+\/config$': '<rootDir>/src/__mocks__/config.js'
  }
};

这个正则表达式^.+\/config$会匹配所有以/config结尾的导入路径（比如../config、../../config），自动替换为你的Mock文件路径。

注意事项： #

• 要确保正则表达式能准确匹配到你所有导入config的场景，避免误替换其他模块。
• 这种方式跳过了Jest的Mock验证机制，直接替换模块导入，适合简单的静态Mock场景。

方案对比与推荐 #

两种方案都能解决你的问题，个人更推荐方案一：

• 它完全遵循Jest的原生Mock逻辑，和你之前在单个测试文件中写jest.mock的行为完全一致；
• 后续如果需要调整Mock逻辑，只需要修改src/__mocks__/config.js即可，维护成本更低；
• 支持Jest Mock的高级特性（比如动态Mock、恢复Mock等），扩展性更强。

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