Figma Variables 间距、尺寸与 UI 密度令牌(Spacing & Density Variables)工程化实战:4px/8px 模数阶梯、Scope 作用域隔离与多端模式切换指南

2026 年 11 月 20 日

许多团队在落地 Figma Variables 变量 时,往往只把颜色(Color)做成了浅色/深色主题,而内边距(Padding)、元素间距(Gap)、组件高度与容器极限宽度依然散落在画布各处手动输入硬编码数字。结果一到“PC 宽屏切紧凑表格模式”或“桌面端转平板与移动端适配”时,设计师只能逐个页面重新拆改 Auto Layout 自动布局,研发也只能靠肉眼对照去猜间距规律。

借助 Figma 原生的 Number(REST API 中对应 FLOAT)数值变量,结合 Scope 作用域精确隔离 与 多维 Mode 正交切换,设计系统完全可以用同一套语义令牌同时驱动“空间尺度体系”与“UI 密度开关”。


一、Spacing / Sizing / Density 三层数值变量架构对比 #

与颜色令牌(详见 Variables 原生 JSON 导入导出与扩展合集实战)相同,严谨的空间尺度体系也应分为基元层、语义层与密度/断点模式层,切忌直接把像素数字暴露给业务页面。

层级划分 推荐 Collection 名称 典型命名规范示例 核心职责与复用范围 建议 Mode 配置
基元数值层(Primitives) Primitives / Scale scale/0、scale/2、scale/4、scale/8、scale/12、scale/16、scale/24、scale/32 锚定 4px / 8px 物理基准阶梯,包含少量 2px、6px 半步微调槽位,全局只读不直接绑定业务组件 单模式(Value)
语义间距与尺寸层(Semantic) Semantic / Layout space/inset/card、space/stack/sm、space/inline/xs、size/control/md 通过 Alias 别名引用基元值,表达“卡片内边距”“列表垂直间距”“控件基准高度”等设计意图 按需开启 Default / Compact / Spacious 三档密度
响应式断点层(Viewport) Responsive / Breakpoint layout/page-gutter、layout/section-gap、layout/container-max 控制整页外边距、区块纵向留白与栅格容器最大宽度,随视口断点一键缩放 Desktop_1440 / Tablet_768 / Mobile_390
组件专属微调层(Component) Component / Density btn/height/md、table/cell-py、input/padding-x 仅在特定高复杂组件(如金融终端表格、工具栏)需要独立覆盖密度倍率时下沉封装 继承或独立覆盖 Compact / Regular

为什么推荐把“UI 密度”与“屏幕断点”拆进两个独立 Collection?

如果你把 Desktop / Mobile 和 Compact / Spacious 塞进同一个集合,4 档断点 × 3 档密度就会产生 12 个组合 Mode,不仅超出 Professional 套餐 4 Modes 上限,维护成本也会指数级上升。将“视口断点”和“界面密度”拆分为两个正交集合后,任意页面都可以自由组合出“Desktop + Compact(后台密集表格)”或“Mobile + Spacious(长辈/触屏大热区)”。


二、实操一:搭建 4px / 8px 基元阶梯与 Scope 作用域防误绑隔离 #

很多团队建完几百个数字变量后,设计师在右侧属性面板点击圆角、描边或文本字号旁的变量图标时,会发现下拉列表里混杂着所有间距和容器宽高变量,极易误绑。解决这一痛点的关键就是严格配置 Variable Scope(作用域)。

1. 建立 Primitives / Scale 绝对数字阶梯 #

  1. 打开右侧面板 Local variables,新建名为 Primitives / Scale 的集合。
  2. 创建 Number 类型变量,建议采用与 Tailwind CSS v4 / Design Tokens 命名规范 对齐的阶梯步长(或以像素直觉命名):
    • 微调半步:scale/2 (2)、scale/6 (6)、scale/10 (10) —— 仅用于图标与文字贴合或徽标内边距;
    • 主力 4px 模数:scale/4 (4)、scale/8 (8)、scale/12 (12)、scale/16 (16)、scale/20 (20)、scale/24 (24)、scale/32 (32)、scale/40 (40)、scale/48 (48)、scale/64 (64)。
  3. 选中所有基元变量(按住 Shift 批量多选),右键 Edit variable,取消勾选 Show in all supported properties(或仅取消全部 Scope 勾选),再勾选 Hide from publishing,从源头禁止业务设计师直接把原始数字 scale/16 绑到业务页面,强迫团队消费语义层变量。

2. 为语义间距、尺寸与圆角变量精准分配 Scope #

新建 Semantic / Layout 集合,通过右键 Create alias 引用 Primitives / Scale,随后按用途严格限定 Scope:

语义变量分组 绑定的 Figma 属性面板位置 必须勾选的 Scope 选项 绝对禁止勾选的 Scope
space/inset/*(内边距)与 space/gap/*(间距) Auto Layout 的 Horizontal/Vertical Padding 与 Gap 仅勾选 Gap & padding(部分版本显示为 Gap) Width and height、Corner radius、Text
size/control/*(控件标准高度/宽度) 图层的 W / H 尺寸框、Min width / Max width 仅勾选 Width and height Gap、Stroke、Font size
radius/*(圆角)与 border/width/*(描边粗细) 图层 Corner radius 与 Stroke weight 圆角仅勾选 Corner radius;边框仅勾选 Stroke Width and height、Gap
opacity/*(不透明度) 图层/填充透明通道 仅勾选 Layer opacity 其他所有长度属性

关于圆角变量的同心嵌套数学关系,可进一步阅读 Figma 圆角系统与同心圆角工程化实战;关于排版字号与行高变量,可参阅 Figma 排版变量(Typography Variables)企业级落地实战。


三、实操二:用 Mode 实现 Compact / Default / Spacious 一键密度切换 #

在 SaaS 后台、数据表格与跨终端应用中,同一套组件往往需要同时服务“桌面高信息密度作业”与“触屏宽松防误触点击”。用数字变量的 Mode 可以彻底告别维护三套重复组件变体的噩梦。

1. 配置三档密度语义矩阵 #

在 Semantic / Layout 集合中添加三个 Mode 列:Default(标准)、Compact(紧凑)、Spacious(宽松),并将同一语义令牌分别指向不同的基元 Alias:

语义变量名称 Compact(高密度作业) Default(常规基准) Spacious(触控/宽松阅读) 典型绑定图层位置
space/card/padding scale/12 (12px) scale/16 (16px) scale/24 (24px) 卡片外框 Horizontal & Vertical Padding
space/stack/item-gap scale/4 (4px) scale/8 (8px) scale/12 (12px) 表单项标题与输入框垂直 Gap
space/inline/control-gap scale/6 (6px) scale/8 (8px) scale/12 (12px) 按钮内部图标与文本水平 Gap
size/control/height-md scale/32 (32px) scale/40 (40px) scale/48 (48px) 按钮、单行输入框、下拉选择框高度 H
size/table/row-height scale/36 (36px) scale/48 (48px) scale/56 (56px) 数据表格行容器最小高度 Min H

2. 绑定 Auto Layout 与极值约束的实操细节 #

  1. 绑定 Padding 与 Gap:选中具备 Auto Layout(Shift + A)的卡片或表格行,点击 Horizontal padding / Vertical padding 输入框,悬浮后点击右侧六边形变量图标,选择 space/card/padding。若需要上下左右不对称内边距,点击输入框旁的 Individual padding 图标,可分别为 Top / Right / Bottom / Left 绑定不同变量。
  2. 绑定 Min / Max 极限尺寸:将容器宽度模式切换为 Fill container 或 Hug contents 后,展开宽度下拉菜单中的 Add min width / Add max width,即可将 layout/container-max 绑定至极限边界。这样容器既保持响应式弹性伸缩,又能随 Responsive / Breakpoint 模式切换自动收紧最大栏宽。
  3. 整页预览一键切换:选中最外层画板或 Section,在右侧 Appearance / Layer 栏点击六边形 Apply variable mode 图标,切换 Semantic / Layout -> Compact 或 Spacious,整页所有表单、表格行高与卡片留白会在 1 秒内无损重组。

绑定 Gap 变量会覆盖 `Space between` 的 Auto 模式

一旦为 Auto Layout 容器的间距绑定了数值变量,该容器就无法同时维持 Auto(即 CSS justify-content: space-between 两端对齐)状态。需要左右贴边自适应分布的顶栏或表头,应保持 Gap = Auto 或改用子图层 Fill container 推挤,切勿强行绑定间距变量。


四、实操三:配置多端 Code Syntax 与 Tailwind / CSS 变量零偏差交付 #

数值变量如果不填写代码语法,工程师在 Dev Mode 开发模式 中看到的依然是 padding: 16px 而不是项目里的 Token 名称(延伸实战见 Figma Variables 驱动组件变体与图层显隐实战)。

1. 为空间变量统一配置三端 Code syntax #

打开任意语义空间变量(如 space/card/padding)的编辑弹窗,滚动到底部 Code syntax 区域,分别添加各端语法:

  • Web(CSS Custom Properties):var(--space-card-padding)(或与 Tailwind CSS v4 对齐为 p-card / gap-stack-sm);
  • iOS(SwiftUI):DS.Spacing.cardPadding;
  • Android(Jetpack Compose):AppTheme.spacing.cardPadding。

2. 前端 CSS 变量与 Tailwind v4 @theme 映射范式 #

前端仓库只需通过 GET /v1/files/:file_key/variables/published(参见 Figma Variables REST API 双向同步实战)或原生 JSON 导出,即可直接编译为与 Figma 密度模式完全一致的 CSS 变量切换开关:

/* 1. 基元与默认语义层(对应 Figma Default Mode) */
:root {
  --scale-4: 4px;
  --scale-8: 8px;
  --scale-12: 12px;
  --scale-16: 16px;
  --scale-24: 24px;
  --scale-32: 32px;
  --scale-40: 40px;
  --scale-48: 48px;

  --space-card-padding: var(--scale-16);
  --space-stack-item-gap: var(--scale-8);
  --size-control-height-md: var(--scale-40);
}

/* 2. 紧凑模式覆盖(对应 Figma Compact Mode) */
[data-density="compact"] {
  --space-card-padding: var(--scale-12);
  --space-stack-item-gap: var(--scale-4);
  --size-control-height-md: var(--scale-32);
}

/* 3. 宽松/适老模式覆盖(对应 Figma Spacious Mode) */
[data-density="spacious"] {
  --space-card-padding: var(--scale-24);
  --space-stack-item-gap: var(--scale-12);
  --size-control-height-md: var(--scale-48);
}

五、Spacing & Density 变量高频踩坑排查表 #

如果在绑定或切换空间变量时遇到界面错位、Dev Mode 不显示 Token 或模式切不动的问题,可按以下清单快速定位(更多通用排障请参阅 Figma 常见报错与疑难故障诊断手册):

异常现象 底层原因定位 标准化排查与修复方法
下拉列表找不到刚建好的间距变量 Scope 作用域未勾选对应属性(如只勾了 Width and height 却想绑到 Padding) 打开该变量的 Edit variable 面板,核对并补勾 Gap & padding(或相应目标 Scope)
切换密度 Mode 后按钮高度没变化 组件高度设为 Hug contents 且内部文字行高+上下 Padding 撑开了外框,未直接绑定 H,或被外层实例手动覆盖成固定数值 若需严格固定控件高度,将 H 设为 Fixed 并绑定 size/control/height-md;若由内容撑开,应改为给上下 Padding 绑定变量
外层画板切换了 Mode,内部子卡片却无动于衷 子组件实例被手动锁定了某一个具体 Mode(不再是 Auto 继承状态),或子卡片引用的变量属于另一个未切换的集合 选中子卡片,在 Apply variable mode 下拉框中将其切回 Auto(跟随父级上下文继承)
Dev Mode 只输出 16px,不显示 var(--space-...) 变量仅设置了名称但未填写 Code syntax,或该变量位于未发布的外部草稿库中 在变量编辑弹窗底部补齐 Web / iOS / Android 的 Code syntax,并将变量库执行 Publish 发布
绑定 Min width 后组件还是被压扁或撑破 Auto Layout 水平方向设为了 Fixed 而非 Fill container / Hug contents,导致极限约束不生效 将图层缩放行为切换为 Fill 或 Hug,Figma 才会激活并尊重绑定的 Min/Max 数值变量

❓ 常见问题与答疑 (FAQ)

高频疑难解析与避坑指南
A

完全不需要。绝大多数核心功能在免费 Starter 计划中均可完整体验与实操练习,无需额外付费购买付费团队版。