#总览

lib 是一个可选的对象数组，用于描述 Rslib 生成的库产物。每个 lib 项对应一份产物，可以包含 lib 配置和 Rsbuild 配置，详情请参考配置 Rslib。

• 类型: LibConfig[]（见 RslibConfig）
• 默认值: [{}]
• 必选: false

省略 lib 字段时，Rslib 会使用等价于 lib: [{}] 的默认配置生成一份产物。产物格式由顶层 format 指定，若未配置，则默认为 'esm'。

显式配置 lib 字段时，其值必须为非空数组。

例如，以下配置会生成 ESM 和 CJS 两份产物：

export default {
  lib: [
    {
      format: 'esm',
    },
    {
      format: 'cjs',
    },
  ],
};

#顶层 lib 配置

以下 lib 配置可以写在 lib 字段外作为顶层配置，在各个 lib 产物之间共享；也可以写在 lib 项中，用于单独配置对应产物：

• autoExtension
• banner
• bundle
• dts
• externalHelpers
• footer
• format
• outBase
• redirect
• shims
• syntax
• wasm

#非顶层 lib 配置

以下 lib 配置不支持顶层配置，只能写在 lib 项中，用于单独配置对应产物：

• experiments
• id
• umdName