测试imagemin时报ERR_REQUIRE_ESM:需使用import加载ES Module如何解决
报错根因
imagemin@8.x 及以上版本为纯ES模块,仅支持import语法导入,不支持CommonJS的require语法导入。你当前项目的Babel编译配置会把TypeScript中的import转译为require,因此触发了兼容报错。
解决方案(三种可选,优先推荐前两种)
方案1:降级到支持CommonJS的版本(最简便,无需修改业务/配置代码)
- 卸载当前版本:
yarn remove imagemin imagemin-mozjpeg - 安装兼容CommonJS的低版本:
yarn add imagemin@7.0.1 imagemin-mozjpeg@8.0.0 - 重新执行
yarn run build、yarn run start即可正常运行,原有代码逻辑无需任何调整。
方案2:切换项目为纯ESM模式(适配最新版本,长期使用更推荐)
- 在
package.json中新增配置项"type": "module",告知Node.js当前项目默认按ES模块处理.js文件。 - 修改Babel配置(
.babelrc或babel.config.json),关闭CommonJS转译:
{ "presets": [ ["@babel/preset-env", { "targets": { "node": "16" }, "modules": false }], "@babel/preset-typescript" ] }
- 移除冗余的ESM兼容逻辑:
- 卸载esm依赖:
yarn remove esm - 删除
main.ts文件,将启动入口改为index.ts - 修改
package.json的scripts.start为"start": "node ./dist/index.js"
- 卸载esm依赖:
- 修改
tsconfig.json配置,确保输出ES模块格式:
{ "compilerOptions": { "module": "ESNext", "moduleResolution": "NodeNext", // 其余原有配置保持不变 } }
- 重新执行构建、启动命令即可。
方案3:使用动态import加载(无需修改全局配置,临时适配可选)
直接修改index.ts的导入逻辑,用动态import()加载纯ES模块:
(async () => { const imagemin = (await import('imagemin')).default; const imageminMozjpeg = (await import('imagemin-mozjpeg')).default; const files = await imagemin(["your-image.jpg"], { destination: "compressed-images", plugins: [ imageminMozjpeg({quality: 50}) ] }); console.log(JSON.stringify(files, null, 1)); })();
修改后重新构建启动即可。
内容的提问来源于stack exchange,提问作者David Faizulaev
相关产品推荐
相关产品推荐

