You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.15 20:02:35