CommonJS环境用pkg打包后动态import ES模块报错如何解决

• pkg工具的核心原理是将Node.js运行时、业务代码、依赖包打包为单文件可执行程序，打包阶段只会静态识别CommonJS规范的require()调用，不会主动解析动态import()语句引用的依赖，因此dateformat的ES模块文件默认不会被打包进最终产物。
• 目前pkg对ES模块动态导入的原生支持存在兼容性缺陷，Node.js的import()接口在pkg构建的沙箱运行环境中缺少对应的宿主配置参数，就会抛出TypeError: Invalid host defined options错误，属于pkg的已知问题，和业务代码逻辑无关。

• 方案1：降级使用CommonJS版本的依赖
  dateformat的v4.6.3是最后一个支持CommonJS规范的版本，直接降级依赖即可完全避开动态导入的问题，改造成本最低：

npm uninstall dateformat
npm install dateformat@4.6.3

代码中直接删除异步自执行函数的动态导入逻辑，改为const dateformat = require('dateformat')引入即可。

• 方案2：配置pkg主动打包ES模块资源
  如果必须使用新版dateformat的ES模块版本，需要在package.json中添加pkg配置，明确指定要打包的ES模块文件：

{
  "pkg": {
    "assets": [
      "node_modules/dateformat/**/*.mjs"
    ]
  }
}

同时保留你测试过的绝对路径导入写法await import('../../../node_modules/dateformat/lib/dateformat.mjs')，不要使用包名导入，pkg打包后的虚拟路径不支持ES模块的包名映射。

• 方案3：项目整体切换为ES模块规范
  将入口文件后缀改为.mjs，或者在package.json中添加"type": "module"配置，所有require调用改为静态import写法，pkg对静态导入的ES模块支持正常，不会触发动态导入的报错，适合后续计划整体迁移到ES模块的项目。

内容的提问来源于stack exchange，提问作者sjsam