TypeScript+Webpack+webpack-node-externals下ERR_REQUIRE_ESM错误求助
解决TypeScript + Webpack + webpack-node-externals场景下的
ERR_REQUIRE_ESM错误 背景说明
- Node.js模块生态现状:截至2024年底,CommonJS仍是默认模块系统,但ECMAScript模块(ESM)的迁移进程一直在推进。实际项目中常混合存在CommonJS与ESM模块,迁移并非简单替换
require()为import、在package.json添加"type": "module"就能完成,存在诸多兼容性问题。 - 技术栈约束:开发一款项目构建工具,源码基于TypeScript编写,通过Webpack构建。已知Webpack会部分忽略
tsconfig.json配置,以自身配置为准,其中target: "node"会直接影响输出模块的类型;必须使用webpack-node-externals工具,否则使用原生Node.js模块或npm模块时会出现大量警告与错误。
具体问题
构建过程无异常,但执行构建后的入口文件时,频繁触发ERR_REQUIRE_ESM错误。涉及的纯ESM模块包括:
gulp-imagemin(8.0.0+版本)imagemin(8.0.0+版本)w3c-html-validator(1.8.2版本)
已提供可复现问题的仓库,执行对应命令即可触发错误,修改源码后执行npm run build可重新构建。
现有临时方案(均非理想)
- 动态
import():需要对现有代码进行大规模重构,开发成本极高。 - 在
package.json中添加"type": "module":会破坏现有项目结构及依赖兼容性,风险不可控。
需求
寻求适配TypeScript + Webpack + webpack-node-externals技术栈的有效解决方案,请勿建议使用其他工具替代Webpack。
内容的提问来源于stack exchange,提问作者Takeshi Tokugawa YD
相关产品推荐
相关产品推荐

