javascript 单元测试模块导入报错通常是因为测试运行器无法解析 es module (esm) 语法或 commonjs 格式,或者路径别名未正确配置。解决的核心做法是确保测试环境(如 jest、vitest)的配置文件与源码的模块系统一致,并通过 modulenamemapper 或 resolve.alias 处理路径映射,从而让测试脚本能正确找到并加载被测试的模块。

Jest 如何配置以支持 ESM 模块导入
Jest 默认使用 CommonJS,若项目使用 ESM 需显式声明。在 package.json 中设置 "type": "module",或在 Jest 配置中将 transform 指向 babel-jest 并使用 @babel/preset-env 进行转译。这样 Jest 能在运行时将 ESM 转换为 CommonJS,避免 Cannot use import statement outside a module 错误。

{
"name": "my-test-project",
"type": "module",
"devDependencies": {
"jest": "^29.0.0",
"@babel/core": "^7.0.0",
"@babel/preset-env": "^7.0.0",
"babel-jest": "^29.0.0"
},
"jest": {
"transform": {
"^.+\.js$": "babel-jest"
}
}
}
上述配置中,babel-jest 负责转换所有 .js 文件。配合 @babel/preset-env,它能自动识别 ESM 语法并将其转为 Jest 可执行的 CommonJS 格式。运行 npx jest 时,Jest 会先经过 Babel 处理,再执行测试,从而解决导入报错问题。
立即学习“Java免费学习笔记(深入)”;
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
Vitest 如何处理路径别名与模块解析
Vitest 原生支持 ESM 且基于 Vite,因此对路径别名(如 @/components)的支持更直接。需在 vite.config.js 中配置 resolve.alias,并在测试文件中直接使用别名导入。Vitest 会在构建阶段解析这些别名,无需额外转换步骤,避免了因模块解析失败导致的导入错误。

// vite.config.js
import { defineConfig } from 'vite';
import path from 'path';
export default defineConfig({
resolve: {
alias: {
'@': path.resolve(__dirname, './src')
}
}
});
// test/example.test.js
import { myFunction } from '@/utils/helper';
it('should work with alias', () => {
expect(myFunction()).toBe(true);
});
在此示例中,vite.config.js 定义了 @ 指向 ./src 目录。测试文件中使用 import { myFunction } from '@/utils/helper',Vitest 会自动将其解析为 ./src/utils/helper。这种配置确保了模块路径的正确性,消除了因相对路径错误或别名未定义导致的导入异常。
当导入路径包含 .js 扩展名时报错怎么解决
在某些严格遵循 ESM 标准的浏览器或 Node.js 环境中,导入本地文件必须显式指定 .js 扩展名。若省略扩展名导致 ERR_MODULE_NOT_FOUND,需在导入语句中添加 .js,或在打包工具中配置 extensions 以自动补全。对于 Jest,可通过 moduleNameMapper 强制添加扩展名;对于 Vitest,Vite 默认已处理此问题,但若手动配置需确保 resolve.extensions 包含 '.js'。

















