我之前在结合@std/esm和Jest做ESM项目测试时也踩过类似的坑，手动模拟模块不生效通常是模块解析、配置或者调用方式的问题，咱们一步步来排查：

1. 确保Jest能找到你的__mocks__目录 #

Jest默认会在模块的同级目录或项目根目录的__mocks__里查找模拟，但如果你的目录结构特殊，需要在Jest配置里明确告知：

• 检查jest.config.js（或package.json中的jest字段），确保roots包含__mocks__所在的目录，比如：

  module.exports = {
    roots: ['<rootDir>', '<rootDir>/src'] // 假设__mocks__在项目根目录
  };
  

• 也可以通过moduleDirectories添加__mocks__所在的路径，让Jest解析模块时优先查找模拟。

2. 模拟模块的命名和导入路径必须完全匹配 #

这是最容易忽略的点：

• 如果你的待测试文件db.mjs里导入的是./utils/db-connector.mjs，那__mocks__里的模拟文件必须是同路径层级+同名（比如__mocks__/utils/db-connector.mjs），或者如果是根目录的__mocks__，文件名要和导入的模块名完全一致（包括大小写，因为很多系统区分大小写）。
• 第三方模块的话，直接在根目录__mocks__下创建同名文件即可，但本地模块一定要对应导入路径的结构。

3. 适配@std/esm的模块解析规则 #

@std/esm会改变Node的模块解析逻辑，和Jest的默认解析可能冲突，需要在Jest配置里正确关联：

• 在jest.config.js中设置transform，让Jest用@std/esm处理.mjs文件：

  module.exports = {
    transform: {
      '^.+\\.mjs$': '@std/esm'
    },
    moduleFileExtensions: ['mjs', 'js'] // 确保Jest识别.mjs扩展名
  };
  

• 检查package.json中的@std/esm配置，避免开启cjs模式或其他会强制CommonJS解析的选项，这可能导致Jest跳过ESM模块的模拟。

4. 显式调用jest.mock()（本地模块必须做） #

Jest不会自动模拟本地模块，必须在测试文件里显式声明要使用模拟：
比如你的db.mjs导入了./db-connector.mjs，那测试文件里要加上：

import db from '../src/db.mjs';
// 这里的路径要和db.mjs里的导入路径完全一致
jest.mock('../src/db-connector.mjs');

test('测试数据库连接使用模拟模块', () => {
  // 你的测试逻辑
});

第三方模块不需要这一步，但本地模块必须显式调用jest.mock()触发模拟。

5. 清除Jest缓存 #

有时候Jest会缓存已加载的模块，导致新的模拟无法生效，运行以下命令清除缓存后再重试：

jest --clearCache

6. 检查文件扩展名一致性 #

如果你的待测试文件是.mjs，模拟模块也应该用.mjs扩展名，并且确保导入时的扩展名和实际文件一致（比如不要在代码里省略扩展名但模拟文件带扩展名，反之亦然），避免解析不一致。

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