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

# Rslib

[Rslib](https://rslib.rs) 是基于 Rsbuild 的库开发工具，用于构建 JavaScript 库和 UI 组件库。

如果你的库使用 Rslib 构建，可以使用 Rstest 编写和运行测试，并通过适配器复用 Rslib 配置中与测试相关的部分，减少重复配置，让测试编译与库构建保持一致。

## 快速开始

### 新项目

创建 Rslib + Rstest 项目时，加上 `--tools rstest`：

```bash
npx create-rslib --template react-ts --tools rstest --dir my-project
```

脚手架会包含 Rstest 和示例测试。使用 `npm run test` 运行测试。

### 已有项目

已有项目可以参考[快速开始](/zh/guide/start/quick-start.md)，完成 Rstest 的安装和测试脚本配置。

## 复用 Rslib 配置

[@rstest/adapter-rslib](https://www.npmjs.com/package/@rstest/adapter-rslib) 会读取 Rslib 配置，并将测试编译需要的配置转换为 Rstest 配置。

### 安装适配器


```sh [npm]
npm add @rstest/adapter-rslib -D
```

```sh [yarn]
yarn add @rstest/adapter-rslib -D
```

```sh [pnpm]
pnpm add @rstest/adapter-rslib -D
```

```sh [bun]
bun add @rstest/adapter-rslib -D
```

```sh [deno]
deno add npm:@rstest/adapter-rslib -D
```

### 扩展配置

```ts title="rstest.config.ts"
import { defineConfig } from '@rstest/core';
import { withRslibConfig } from '@rstest/adapter-rslib';

export default defineConfig({
  extends: withRslibConfig(),
});
```

适配器会读取 `rslib.config.ts`，转换测试编译需要的选项，将结果与 Rstest 配置合并，并将已加载的配置文件加入 [`forceRerunTriggers`](/zh/config/test/force-rerun-triggers.md)，因此当该配置发生变化时，`--changed` 会运行完整测试套件。

它不会复制 `dev`、`server`、`html` 等只用于构建的配置。如果默认配置位置或 library 选择不适合当前项目，可以使用 `cwd`、`config` 或 `libId`。

完整的 options、配置映射、cache 行为和调试方法请查看[配置参考](/zh/integration/rslib/reference.md)。

## 相关文档

- [Rslib 配置概览](https://rslib.rs/config)