开发工具#UI 设计

Semi Design:字节开源的 React 组件库与设计系统

Semi Design 是字节开源的 React 组件库,Figma 插件把设计稿转成代码,DSM 平台管 2,700 多个 Token,适合中后台项目。

项目资料

GitHub Ecosystem
仓库地址github.com/DouyinFE/semi-design
许可证
MIT
主语言
TypeScript
星标
10,453
核查时间
2026-11-01

以上快照资料以核查当日为准,可能随版本或运营策略变化。

接一个中后台项目,从零画表格、表单、弹窗这些基础组件,一周就耗在重复劳动上。Semi Design 是字节跳动抖音前端团队开源的 React 组件库和设计系统,把这套基础件做全了:官方标注 8,000 多个组件变体、60 多个开箱组件,覆盖表格、表单、弹窗、导航到日历。截至 2026 年 11 月 1 日,仓库有 10,453 颗星,MIT 许可证,主要语言 TypeScript。它已经在服务字节内部产品,外部项目可以直接 npm install @douyinfe/semi-ui 起步。

Semi Design 的 DSM 设计平台里调整 Design Token 的界面

核心功能

Semi 最有辨识度的一块是 DesignOps 与 DevOps 的打通。设计师在 Figma 里用官方 UIKit 摆界面,装上 Semi 的 Figma 插件后可以把设计稿一键转成真实的 React 代码,减少「设计稿一套、代码另一套」的偏差。代码侧则由 DSM(Design System Management)平台管理主题:2,700 多个 Design Token 集中在 DSM 里改颜色、圆角、字号,换品牌风格不用逐个改组件样式。上图就是 DSM 里调整 Token 的界面。

典型使用场景

组件按 W3C 标准做了键盘交互和焦点管理,全量组件支持 RTL(从右向左)布局,内置国际化方案覆盖 50 多种语言。做面向政企或海外用户的后台时,这些能力省下的是合规检查和逐页适配的时间。TypeScript 全程编写,类型定义完整,也支持服务端渲染——Next.js 项目里实测不需要额外的适配层。官网还提供全套设计文档:每个组件的 API、设计规范和无障碍说明在同一页,设计资源和代码文档用同一套词表,跨职能协作时少一层翻译。

快速上手

装依赖后引入组件即可:

npm install @douyinfe/semi-ui
import React from 'react';
import { Button } from '@douyinfe/semi-ui';

const App = () => <Button type="primary">你好</Button>;

官网 semi.design 有全部组件的文档和在线 Demo,每个组件页都能直接改参数看效果;Figma UIKit 在 Figma 社区搜 Semi Design 可以找到。NPM 周下载量在组件库里属第一梯队,遇到问题先查 GitHub Discussions。如果想看整套后台的成品排布,可以再对比 Shadcn Admin 那类界面集合——Semi 给的是组件与设计系统,Shadcn Admin 给的是可以直接抄的页面。

小结

Semi Design 适合接中后台项目、又不想在基础组件上重复花时间的 React 团队,尤其是设计稿和代码要同源维护的场景。要注意两点:它是字节主导的开源项目,issue 响应依赖社区;组件风格自带设计语言,深度定制前先评估 DSM 的 Token 能否覆盖你的品牌要求。仓库以 MIT 发布,GitHub 数据核验于 2026 年 11 月 1 日。