# @getsoren/design-system 中文文档

规范地址：https://npmcn.com/package/%40getsoren/design-system/

版本：4\.97\.0
npm 元数据更新时间：2026-11-11T16:27:21.587Z
中文译文更新时间：2026-11-16T06:49:28.272Z
软件包许可：ISC

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40getsoren/design-system
原文对照：https://npmcn.com/package/%40getsoren/design-system/?lang=original
项目主页：https://github.com/getsoren/design-system#readme
源码仓库：https://github.com/getsoren/design-system

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：3 MB，674 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：5 个
- peer 依赖：react ^17\.0\.0 \|\| ^18\.0\.0 \|\| ^19\.0\.0，react-dom ^17\.0\.0 \|\| ^18\.0\.0 \|\| ^19\.0\.0，@mui/material \>=6\.0\.0，@emotion/react \>=11\.0\.0，@emotion/styled \>=11\.0\.0，@getsoren/react-utils \>=1\.24\.0，@tanstack/react-virtual \>=3\.0\.0
- 首次发布：2026-05-15T22:03:32.917Z
- 最新版本发布：2026-11-11T16:27:21.380Z
- 近 30 天下载量：15178（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：102（近 12 个月 102 个）

## 中文简介

设计系统反应库

## 安装

```sh
npm install @getsoren/design-system
```

也可以使用：`pnpm add @getsoren/design-system`、`yarn add @getsoren/design-system`、`bun add @getsoren/design-system`

## README

# @ getsoren/ 设计系统

**设计系统 React 库**

> 图书馆基于 [MUI 核心](https://mui.com/material-ui/getting-started/overview/)

-   [安装](https://npmcn.com/package/%40getsoren/design-system/#readme-Installation)
-   [使用量](https://npmcn.com/package/%40getsoren/design-system/#readme-Usage)
    -   [提供主题](https://npmcn.com/package/%40getsoren/design-system/#readme-Provide-the-theme)
-   [软件包](https://npmcn.com/package/%40getsoren/design-system/#readme-Package)
-   [文档](https://npmcn.com/package/%40getsoren/design-system/#readme-Docs)
-   [捐款](https://npmcn.com/package/%40getsoren/design-system/#readme-Contributing)

## 安装

**无 :**

```bash
npm install @getsoren/design-system
```

**包子 :**

```bash
bun add @getsoren/design-system
```

**线条**数字 :

```bash
yarn add @getsoren/design-system
```

**小时**数字 :

```bash
pnpm add @getsoren/design-system
```

## 使用量

### 提供主题

打开 `<ThemeProvider>` 在你的申请. 自定义主题可以作为道具提供 `theme={YOUR_CUSTOM_THEME}`

```typescript
import { Button, ThemeProvider } from "@getsoren/design-system";

const App = () => (
  <ThemeProvider>
    <Button>Text</Button>
  </ThemeProvider>
);

export default App;
```

## 软件包

软件包可用于 `@getsoren/design-system/{package}`

| 软件包 | 说明 |
| --- | --- |
| 颜色 | 这个包包含材料设计颜色. |

## 文档

-   [材料UI(MUI)](https://mui.com/material-ui/getting-started/overview)
-   [图片](https://www.figma.com/file/3fprVesPjVIo124UWy9xhU/MUI-for-Figma-Material-Pro-v5.9.0?node-id=4662%3A14)
-   [故事书](https://storybook.tracktor.fr/)

## 捐款

读取 [贡献指南](https://npmcn.com/CONTRIBUTING.md) 了解我们的过程.

## 常见问题

### @getsoren/design-system 是什么？

设计系统反应库

### 如何安装 @getsoren/design-system？

在项目目录运行 npm install @getsoren/design-system，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^17\.0\.0 \|\| ^18\.0\.0 \|\| ^19\.0\.0）、react-dom（^17\.0\.0 \|\| ^18\.0\.0 \|\| ^19\.0\.0）、@mui/material（\>=6\.0\.0）、@emotion/react（\>=11\.0\.0）、@emotion/styled（\>=11\.0\.0）、@getsoren/react-utils（\>=1\.24\.0）、@tanstack/react-virtual（\>=3\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @getsoren/design-system 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @getsoren/design-system 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @getsoren/design-system 可以商用吗？

@getsoren/design-system 使用 ISC 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @getsoren/design-system 的下载量有多少？

根据 npm 官方下载统计，@getsoren/design-system 在 2026/10/17 – 2026/11/15 这 30 天内被下载 15,178 次，日均约 506 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @getsoren/design-system 还在维护吗？

最新版本 4\.97\.0 发布于 2026/11/12（4 天前）；至今共发布 102 个版本，其中过去 12 个月发布了 102 个；首次发布于 2026/05/16。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

