> For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt.

# lib.format

- **类型：** `'esm' | 'cjs' | 'umd' | 'mf' | 'iife'`
- **默认值：** `'esm'`
- **命令行：** `--format <format>`（例如 `--format umd`）
- **顶层配置：** 支持

指定生成的 JavaScript 产物的输出格式。

在不同的产物格式下，Rslib 默认使用的 Rspack 的 [output.library.type](https://rspack.rs/zh/config/output#outputlibrarytype) 值如下：

- `esm`：[modern-module](https://rspack.rs/zh/config/output#type-modern-module)
- `cjs`：[commonjs-static](https://rspack.rs/zh/config/output#type-commonjs-static)
- `umd`：[umd](https://rspack.rs/zh/config/output#type-umd)
- `iife`：开启了 [output.iife](https://rspack.rs/zh/config/output#outputiife) 的 [module](https://rspack.rs/zh/config/output#type-module)

更多详情请参考 [输出格式](/zh/guide/basic/output-format.md) 和 [模块联邦](/zh/guide/advanced/module-federation.md)。

不同产物格式会影响 Rslib 的部分默认行为，详情请参阅 [默认行为](/zh/config/default-behavior.md)。

::: note
`umd`、`mf` 以及 `iife` 格式仅在 [bundle](/zh/config/lib/bundle.md) 设置为 `true` 时有效。
:::