Skip to content

Commit d038b9f

Browse files
committed
docs: add why Rslib chapter
1 parent ebe23ee commit d038b9f

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

website/docs/zh/guide/start/index.mdx

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,21 @@ Rslib 提供了丰富的构建功能,包括:
1010
- **类型声明文件生成**: 包括 isolated declarations。
1111
- **进阶功能**: 模块联邦、资源压缩、PostCSS、Lightning CSS 等。
1212

13+
## 🚀 为什么选择 Rslib
14+
15+
在开发组件库或者工具库的过程中,开发者不仅需要关注项目逻辑的实现,还要考虑项目的构建、调试、文档、测试等等和代码逻辑无关的事情。社区中现有的许多工具与方案,它们通常都能很好地满足其中个别需求,但对于不熟悉这些工具与方案的开发者而言,往往需要繁琐的配置工作或同时使用多种工具配合来满足这些需求。
16+
17+
我们在实践中发现,目前库开发主要面临以下痛点:
18+
19+
- **工具生态不完善**:例如 esbuild 生态无法支持模块联邦功能,webpack 对 library ESM 产物的支持也存在不足。
20+
- **模块规范兼容性问题**:对 ESM、CJS、UMD 等多种模块规范的支持,显著增加了兼容性和互操作性的开发成本。
21+
- **产物优化不足**:库产物在 tree-shaking 和 代码分割等方面的优化效果欠佳。
22+
- **构建性能瓶颈**:部分工具因架构限制而存在明显的性能问题。
23+
- **配置复用性差**:应用项目与库项目的构建配置难以复用与共享,导致开发体验不一致和维护成本较高。
24+
- **开发流程割裂**:库调试、文档和测试等环节缺乏统一的解决方案,与核心开发流程产生割裂。
25+
26+
Rspack / Rsbuild 的不断迭代与发展让我们看到了解决这些问题的可能。Rslib 在其基础上进行了一系列工作,利用 webpack / Rspack 生态的优势,为库开发场景提供了一套完整的开箱即用的解决方案,在构建性能、模块规范兼容性、产物优化等方面都取得了显著的成效。同时,通过统一配置和完善的功能生态,Rslib 能够大幅降低开发者的配置成本,从而提高开发效率与体验。
27+
1328
## 🔥 特性
1429

1530
Rslib 具备以下特性:

0 commit comments

Comments
 (0)