UI 视觉设计 / 知识点
设计系统术语速查手册
核心体系
用于统一产品设计与实现的一套可复用资产、规则、组件、文档和治理机制;它不等于单纯组件库或一份 UI 规范。
定义
**Design System(设计系统,DS)**是一套持续演进的产品设计基础设施,把设计原则、基础样式、Token、组件、模式、代码实现、文档和治理机制组织在一起。
边界
设计系统既包含“能直接复用的资产”,也包含“应该如何使用和演进这些资产”的规则。
Design System
├── Foundations
├── Design Tokens
├── Components
├── Patterns
├── Guidelines
├── Code / Design Assets
└── Governance对比
- Component Library:主要解决组件复用。
- Style Guide:主要记录视觉和使用规范。
- Design System:还要解决一致性、跨端实现、版本和治理。
最小例子
按钮不仅有 Figma 组件,还对应代码组件、颜色 Token、尺寸规则、状态规范、无障碍要求和变更记录,这才进入设计系统范畴。
常见误区
“做了一套组件”不等于“建立了设计系统”。缺少统一规则、文档和治理时,组件很容易重新分叉。
定义品牌在数字产品中的视觉和交互表达方式,如颜色、字体、形态、动效与语气;它提供方向,设计系统负责把方向产品化。
定义
**Design Language(设计语言)**是品牌或产品在数字界面中形成一致感知的表达规则,包括色彩、排版、形态、图标、动效和交互气质。
边界
Design Language 更偏“表达原则与风格”;Design System 更偏“如何把这些原则转化为可复用、可实施的资产”。
对比
Design Language
↓ 转化
Foundations / Tokens / Components
↓ 落地
Product UI最小例子
品牌规定“高对比、克制圆角、快速但柔和的动效”,属于设计语言;将其固化为颜色 Token、Radius Token 和 Motion Token,则属于设计系统实现。
常见误区
不要把某个组件库的默认视觉风格直接当成自己的 Design Language。设计语言首先服务品牌和产品体验。
设计系统最底层的视觉与布局规则集合,通常覆盖颜色、排版、间距、网格、圆角、阴影和动效,是 Token 与组件的共同基础。
定义
**Foundation(基础规范)**是设计系统中最底层、跨组件复用的视觉与布局规则。
常见内容包括:
- Color
- Typography
- Spacing
- Grid
- Radius
- Elevation
- Iconography
- Motion
边界
Foundation 描述系统级基础规则,不直接等同于某个具体组件。
对比
- Foundation:定义“系统有哪些基础能力”。
- Token:把这些能力编码为稳定名称和值。
- Component:组合 Foundation 和 Token 形成可交互 UI。
最小例子
“系统只允许 4、8、12、16、24、32 的间距阶梯”属于 Spacing Foundation。
常见误区
Foundation 不是视觉灵感板。进入 Foundation 的规则应该足够稳定,并能被多个产品和组件复用。
说明设计资产在什么场景应该或不应该使用的规则,通常包含原则、推荐做法、反例和边界;它解决“怎么正确使用”。
定义
**Guideline(设计指南)**用于解释设计系统资产的适用条件、行为规则、内容要求和禁用场景。
边界
组件本身回答“有什么”;Guideline 回答“什么时候用、怎么用、什么时候不要用”。
最小例子
Button Guideline 可以规定:
- Primary Button 只用于页面最高优先级动作。
- 一个任务区域避免出现多个同级 Primary Button。
- 破坏性操作应使用明确文案而不是模糊的“确定”。
对比
- Spec:更偏精确结构和参数。
- Guideline:更偏使用决策和原则。
- Pattern:更偏多个组件如何组合解决任务。
常见误区
只有尺寸标注而没有使用边界,通常不能称为完整 Guideline。
由多个组件和行为规则组合形成的可复用任务解决方案,例如搜索、筛选、登录或批量操作;粒度通常大于单个组件。
定义
**Pattern(设计模式)**是针对反复出现的用户任务,组合多个组件、状态和交互规则形成的可复用解决方案。
边界
Pattern 不是单一控件,也通常不是完整业务页面。
Pattern: 搜索与筛选
├── Search Field
├── Filter
├── Active Filters
├── Result Count
├── Empty State
└── Clear Action对比
- Component:基础交互构件。
- Pattern:组件组合后的任务方案。
- Template:更偏页面骨架。
最小例子
“批量选择 → 批量工具栏 → 确认危险动作 → 操作结果反馈”可以形成一个 Bulk Action Pattern。
常见误区
不要为每个业务页面创建一个 Pattern;只有可跨场景复用的任务结构才值得沉淀。
团队认定的权威设计系统来源,确保 Token、组件、文档和版本信息不会多处各自维护;常简称 SSOT。
定义
**SSOT(Single Source of Truth,单一事实源)**指团队明确哪一份数据或资产是某类设计系统信息的最终权威来源。
边界
SSOT 不代表“所有东西只能放在一个工具里”,而是同一种事实不能存在多个互相竞争的权威版本。
结构示意
Token Source
↓
Design Variables
↓
Code Variables
↓
Docs / Components上游 Token Source 可以是颜色和值的 SSOT,而组件代码仓库可以是组件实现的 SSOT。
最小例子
设计稿里手动维护一份颜色表、代码里再维护另一份颜色常量,如果两者都被当成权威来源,就没有真正的 SSOT。
常见误区
SSOT 的关键不是工具名称,而是明确所有权、同步方向和变更流程。
供设计师直接使用的组件、样式、变量和模板资源集合,常存在于设计工具中;它是设计系统资产的一种载体,不是系统本身。
定义
**Design Kit(设计资源包)**是在设计工具中提供给设计师复用的组件、变量、样式、模板和示例资源。
边界
Design Kit 是设计系统的“设计端分发物”,并不包含完整的代码实现和治理机制。
对比
- Design Kit:设计工具资产。
- Component Library:通常泛指可复用组件集合,可能是设计端或代码端。
- Design System:包含规则、资产、实现和治理的整体。
最小例子
一套包含 Button、Input、Dialog、Color Variables 和页面模板的 Figma Library,可以称为 Design Kit。
常见误区
不要让 Design Kit 成为独立演进的“第二套系统”;它应与代码和文档保持明确同步关系。
集中提供可复用 UI 组件的设计或代码资产集合,用于减少重复实现并保持一致性;它通常只是设计系统的一部分。
定义
**Component Library(组件库)**是一组经过标准化、可重复使用的 UI 组件资产,可以存在于设计工具、Web、iOS、Android 等不同实现中。
边界
组件库主要解决“可复用 UI 构件”,不天然包含设计原则、Pattern、治理、发布策略和使用决策。
对比
Design System
├── Component Library
├── Tokens
├── Foundations
├── Guidelines
└── Governance最小例子
React 包中提供 Button、Checkbox、Modal 和 DataTable,是代码组件库;对应 Figma Library 是设计组件库。
常见误区
组件库数量多不代表设计系统成熟。重复组件、命名不统一和行为不一致反而会提高维护成本。
Design Token
以稳定名称表达设计决策的数据项,例如颜色、字号、间距或圆角;Token 将语义与具体值解耦,便于主题化和跨端同步。
定义
**Design Token(设计令牌,DT)**是把设计决策保存为“稳定名称 + 可替换值”的数据表达。
color.text.primary
↓
#161616边界
Token 不是普通变量的同义词。一个高质量 Token 应代表可复用的设计决策,并具有明确命名层级和使用边界。
对比
- Hard-coded Value:直接写
#161616。 - Token:使用
color.text.primary。 - Theme:改变 Token 在某个环境中的最终映射。
最小例子
设计和代码都引用 color.text.primary,深色主题只替换它的值,组件无需逐个修改。
常见误区
不要把每一个像素值都 Token 化。只有具有系统复用价值的设计决策才值得成为 Token。
直接描述基础值或尺度的底层 Token,如 blue-600、space-200;它回答“值是什么”,通常不直接表达业务或组件语义。
定义
**Primitive Token(原始令牌)**保存最基础的色值、尺寸或尺度,是 Token 架构中的底层原料。
例如:
color.blue.600 = #0f62fe
space.200 = 8px
radius.100 = 4px边界
Primitive Token 通常描述“值属于哪个基础尺度”,而不是“这个值应该用在哪里”。
对比
Primitive
color.gray.900
↓
Semantic
color.text.primary最小例子
组件应优先引用 color.text.primary,而不是直接引用 color.gray.900,这样主题变化时语义仍然稳定。
常见误区
把 Primitive 当最终业务 API 会让大量组件和具体色阶强耦合,后续主题化成本很高。
按用途而非具体视觉值命名的 Token,如 text-primary、border-subtle;它表达“为什么使用”,是主题切换的重要抽象层。
定义
**Semantic Token(语义令牌)**使用设计角色和用途命名,而不是直接描述具体颜色或尺寸值。
例如:
color.text.primary
color.background.surface
color.border.danger边界
Semantic Token 的名称应该在主题切换后仍然成立。
对比
blue.600:Primitive,描述具体色阶。action.primary:Semantic,描述作用。button.primary.background:Component Token,描述具体组件属性。
最小例子
浅色主题下 text.primary → gray.900,深色主题下可映射到 gray.100,但组件始终使用同一个语义名称。
常见误区
不要在 Semantic Token 名称中偷偷固定颜色,例如 primary-blue-text,否则语义层又重新绑定了实现值。
自身不直接保存最终值,而是引用另一个 Token 的中间映射;常用于建立 Primitive、Semantic 与 Component Token 之间的依赖关系。
定义
**Alias Token(别名令牌)**的值来自另一个 Token 引用,而不是直接保存最终颜色、尺寸或字体值。
结构示意
color.blue.600
↓
action.primary
↓
button.primary.background其中后两层都可能通过 Alias 关系间接获得值。
边界
Alias 描述的是“引用关系”,Primitive / Semantic / Component 描述的是“Token 所处角色”,两者不是完全同一维度的分类。
最小例子
button.primary.background 可以引用 color.action.primary,而不是再次写一遍 #0f62fe。
常见误区
Alias 链条不是越长越好。层级过多会让排查最终值和影响范围变得困难。
只服务某个组件或组件族的细粒度 Token,例如 button-primary-bg;适合确有局部差异时使用,不应替代全局语义 Token。
定义
**Component Token(组件令牌)**是绑定某个具体组件及其属性、状态或变体的 Token。
例如:
button.primary.background
button.primary.text
button.primary.background.hover边界
只有当全局 Semantic Token 无法准确表达组件局部需求时,才需要 Component Token。
对比
- Semantic Token:全系统复用。
- Component Token:局部组件范围。
- Primitive Token:最底层值。
最小例子
如果所有主操作都共享 action.primary,Button 可以直接使用语义 Token;只有按钮确实需要特殊映射时再增加组件层。
常见误区
为每个组件的每个 CSS 属性创建 Component Token,会迅速造成 Token 爆炸和维护负担。
用于编码背景、文字、边框、图标、状态等颜色决策的 Token;推荐按角色和状态命名,而不是让组件直接依赖十六进制色值。
定义
**Color Token(颜色令牌)**把产品中的颜色决策编码为稳定名称。
常见语义角色包括:
- Background
- Surface / Layer
- Text
- Border
- Icon
- Action
- Support / Status
- Focus
边界
颜色 Token 不只是“品牌色表”,还应表达界面中的语义角色和交互状态。
最小例子
color.text.primary
color.text.secondary
color.border.subtle
color.status.danger常见误区
仅建立 gray-1 到 gray-10 的色板还不够。那更接近 Primitive Palette,而不是完整的语义颜色体系。
编码字号、字重、行高、字族和字距等排版决策的 Token,通常按正文、标题、标签等角色组织,避免页面自由组合字体参数。
定义
**Typography Token(排版令牌)**将一组字体属性作为稳定的文本角色提供给产品使用。
例如:
type.heading.lg
type.body.md
type.label.sm一个 Type Token 可能同时包含 font-size、font-weight、line-height 和 letter-spacing。
边界
Typography Token 表达的是可复用排版角色,不是简单把每个字号命名一次。
最小例子
页面标题统一使用 type.heading.lg,而不是每个页面分别手写 24px / 32px / 600。
常见误区
不要允许设计师任意组合“系统字号 + 任意字重 + 任意行高”,否则 Token 无法真正约束排版一致性。
将 Padding、Margin、Gap 等空间值收敛到有限尺度,用统一 Token 表达;可减少随意像素值并建立稳定的视觉节奏。
定义
**Spacing Token(间距令牌)**把布局中的间距收敛为可复用尺度,用于 Padding、Margin、Gap 和组件内部空间。
结构示意
space.050 → 2
space.100 → 4
space.200 → 8
space.300 → 12
space.400 → 16具体命名和尺度由系统自行定义。
边界
Spacing Token 不是要求“所有空间都完全相同”,而是避免无意义的 13px、17px、19px 等随机值扩散。
最小例子
卡片内边距、表单字段间距和页面 Section 间距都从同一 spacing scale 中选择。
常见误区
不要用 Token 名称表达具体像素值后又频繁改变实际值,否则名称和语义会产生冲突。
将控件、卡片、弹层等圆角收敛为有限等级,使产品形态保持一致;应表达尺寸或语义层级,而不是各页面自行设置。
定义
**Radius Token(圆角令牌)**定义系统允许使用的圆角等级,并统一组件形态语言。
例如:
radius.none
radius.sm
radius.md
radius.lg
radius.full边界
Radius Token 的价值在于限制随意值并形成形态一致性,不要求所有组件使用相同圆角。
最小例子
Button 使用 radius.md,Tag 使用 radius.full,Card 使用 radius.lg,它们仍然来自同一 Radius Scale。
常见误区
不要给每个组件独立创造 button-radius、card-radius,除非它们确实需要独立主题化或治理。
表达浮层、卡片或导航等在视觉层级上的高度关系,通常映射到阴影、边框或其他层级效果;不应简单等同于某个阴影值。
定义
**Elevation Token(层级令牌)**表达界面元素在视觉层级上的相对关系。
它可能映射为:
- Shadow
- Border
- Background difference
- Overlay
- 多种效果组合
边界
Elevation 表达“层级语义”,Shadow 只是可能的视觉实现之一。
最小例子
elevation.base
elevation.raised
elevation.overlay
elevation.modal对比
一个扁平风设计系统也可以有 Elevation,只是可能通过背景和边框表达层级,而不使用明显阴影。
常见误区
不要把“阴影越重 = 层级越高”当成固定规则。层级首先服务界面结构和可理解性。
编码 Duration、Easing、Delay 等动效参数,使组件过渡拥有统一节奏;适合统一系统级运动语言并支持减少动态效果等偏好。
定义
**Motion Token(动效令牌)**把持续时间、缓动和其他重复运动参数统一为系统级设计决策。
例如:
motion.duration.fast
motion.duration.standard
motion.easing.enter
motion.easing.exit边界
Motion Token 只定义可复用参数;具体动画的路径、触发条件和状态变化仍属于组件或 Pattern 行为。
最小例子
Tooltip、Menu 和 Dialog 的进入动画都从统一 Duration Scale 与 Easing Token 取值。
常见误区
不要给每个组件独立创造完全不同的动效时长。缺乏统一节奏会让产品显得松散且难以预测。
编码图标、控件高度、触控目标等可复用尺寸尺度;适用于明确具有系统复用价值的尺寸,不应把所有宽高都 Token 化。
定义
**Size Token(尺寸令牌)**用于表达系统中跨组件复用的尺寸尺度,例如图标尺寸、控件高度和可点击区域等级。
边界
Size Token 不应该覆盖所有布局宽高。响应式容器、内容宽度等往往需要由布局规则决定。
最小例子
size.icon.sm
size.icon.md
size.control.md
size.touch-target.min对比
- Spacing Token:元素之间或内部的空间。
- Size Token:元素本身具有稳定复用价值的尺寸。
常见误区
将 width: 347px 这类一次性页面尺寸 Token 化,通常只是在把硬编码换一个名字。