output.module
- 类型:
boolean - 默认值:
false
是否以 ES 模块格式输出 JavaScript 文件。
Tip
- 此功能目前为实验性功能,仅在 output.target 为
'web'或'node'时可用。 - 如果你需要构建 ESM 格式的 JavaScript 库,推荐使用 Rslib,它是一个开箱即用的库开发工具,基于 Rsbuild 实现。
Web 应用
在构建 Web 应用时,Rsbuild 默认会生成 IIFE 格式的产物。
如果你希望输出 ES Modules 格式,可以将 output.module 设置为 true:
rsbuild.config.ts
Tip
开启 output.module 后,Rsbuild 生成的 <script> 标签会自动添加 type="module" 属性,即 html.scriptLoading 为 'module'。
Node.js 应用
在构建 Node.js 应用时,Rsbuild 默认输出 CommonJS 格式的产物,你可以将 output.module 设置为 true 来输出 ES modules 格式:
rsbuild.config.ts
运行 ESM 产物
为了在 Node.js 中正确运行 ESM 产物,你可以选择以下任一方式:
- 将 package.json 的
type字段设置为'module':
package.json
- 将输出的 JavaScript 文件扩展名改为
.mjs:
rsbuild.config.ts

