ES Modules单元测试需适配ESM加载机制，首选Vitest（零配置支持顶层await、动态import及vi.mock）；路径须带扩展名，mock需在加载前完成。
ES Modules（ESM）的单元测试需要适配模块加载机制，不能直接用 CommonJS 方式 require，需借助支持 ESM 的测试运行器或配置。核心是让测试环境能正确解析 import/export 语法，并处理顶层 await、动态 import 等特性。
选对测试运行器：优先用原生 ESM 支持的工具
Vitest 是目前最推荐的选择，它默认启用 ESM 支持，零配置即可测试 .mjs 或 type="module" 的 package.json 项目。Jest 从 29+ 开始实验性支持 ESM，但需显式设置 type: "module" 并禁用自动转换（如关闭 babel-jest 或配置 esbuild 预处理器）。Node.js 原生 test runner（v18.17+）也支持 ESM，但生态和断言能力较弱，适合简单场景。
确保模块解析路径正确
ESM 对路径更严格：相对路径必须带扩展名（./utils.mjs），不能省略 .js/.mjs；裸导入（如 import { foo } from 'lodash'）依赖 node_modules 中包的 exports 字段声明。常见报错 “Cannot find module” 往往因路径缺失扩展名或 package.json 缺少 "type": "module"。建议统一使用 .js 后缀 + type="module"，避免 .mjs 混用。
处理顶层 await 和动态 import
Vitest 和 Node 原生 test runner 允许在测试文件中使用顶层 await（如等待异步初始化），无需包裹在 test() 内。动态 import() 在 ESM 中是 Promise，测试时需 await：
const { myFn } = await import('./module.js');
若被测模块本身含顶层 await（如初始化数据库连接），Vitest 会自动等待；Jest 则可能需 mock 或改用异步 setup。
Mock ESM 模块要换方式
- Vitest 使用 vi.mock()，支持自动 mock 和手动 factory 函数，语法简洁：
vi.mock('./api.js', () => ({ fetchData: vi.fn().mockResolvedValue('ok') })); - Jest 的 jest.mock() 在 ESM 下需配合 __mocks__ 目录或 ES 模块 factory，且不能在顶层调用（需放在 test 块内或用 jest.unstable_mockModule）
- 避免用 require.cache 清除模块——ESM 不支持该方式，mock 必须在模块加载前完成
不复杂但容易忽略。关键是选对工具链、写对路径、用对 mock API，而不是强行把 CJS 测试逻辑套到 ESM 上。
