Rslib 1.0：面向 JavaScript 库、组件库和 CLI 的构建工具
应用构建工具和库构建工具解决的不是同一个问题。应用通常需要产出一组可部署资源，而 JavaScript 库需要兼容不同消费者、模块系统、类型声明、构建目标和发布方式。Rslib 1.0 的定位，就是在 Rsbuild 基础上为库开发提供统一工程入口。
本文根据 ByteDance Web Infra 关于 Rslib 1.0 的公开摘要整理。摘要披露的能力包括编译、类型生成、资源处理、ESM/CJS 输出、打包或保留模块结构，以及与 Rstest、Rspress 等工具组合；具体配置字段应以当前官方文档为准。
一、Rslib 解决什么问题
手动维护库构建通常要拼接多个工具：TypeScript 负责类型，Babel 或 SWC 负责语法转换，打包器负责模块输出，插件处理 CSS、图片和声明文件，发布配置再决定 exports。工具越多，配置之间越容易不一致。
Rslib 的统一入口可以让团队集中管理：
- 编译目标和语法降级；
- ESM、CJS 等模块格式；
- 类型声明生成；
- CSS、图片和其他资源；
- 是否打包依赖；
- 是否保留模块结构；
- 开发、测试、文档和发布流程。
二、打包与保留模块结构如何选择
| 输出策略 | 适合场景 | 代价 |
|---|---|---|
| 打包 | 组件库、单入口工具、减少消费者配置 | 体积、Tree Shaking 和依赖边界需验证 |
| 保留模块结构 | 多入口库、按需加载、希望消费者继续 Tree Shaking | 发布目录和 exports 更复杂 |
选择不能只看构建是否成功。还要测试 Node、浏览器、Bundler、TypeScript 和不同模块解析条件下的真实消费。
三、类型生成是发布契约
类型文件不是构建附属物，而是库用户看到的 API。发布前应验证：
- 公共 API 都有声明；
- 私有实现没有意外暴露；
- 路径别名在声明中可解析；
- ESM/CJS 入口与类型入口对应；
- TypeScript 不同版本的兼容性。
周刊摘要提到类型生成适配 TypeScript 7。版本事实和兼容范围属于随工具变化的内容，使用前需要以 Rslib 和 TypeScript 当前文档核对。
四、和 Rstest、Rspress 组合
库工程的完整循环不仅是 build：
源代码 → Rslib 构建 → Rstest 验证 → Rspress 文档 → 发布包
构建测试应检查产物能否被真实消费者安装和导入；文档站则应引用公共 API 和示例，而不是只展示源码内部实现。
五、迁移检查清单
- 明确支持的 Node、浏览器和模块格式。
- 测试 ESM、CJS、类型和多入口导入。
- 检查
exports、types、main和module字段。 - 验证依赖是打包、外置还是 peer dependency。
- 构建后用临时消费者项目安装测试。
- 类型声明和文档示例与实际导出一致。
- 将构建、测试、文档和发布纳入同一 CI 流程。
来源与边界
原文：ByteDance Web Infra｜Rslib 1.0 正式发布：面向多场景的 JavaScript 库开发工具。本文依据奇舞周刊第 597 期摘要整理，未取得原文全文和配图；命令、配置字段和 TypeScript 兼容矩阵请以 Rslib 官方文档为准。