Variables(变量)入门 #
依据官方文档整理:Guide to variables in Figma (opens new window)。功能可用性因方案与席位而异,以账号内实际界面为准。
Variables(变量) 用于存储可复用的值,并可绑定到设计属性与原型动作。典型用途包括:
- 用设计令牌(design tokens)管理颜色、间距等,提升设计系统维护效率
- 借助 Mode 在浅色 / 深色等主题间切换,并同步间距与文案等
- 在原型中用变量保存状态,配合表达式与条件逻辑减少重复画板
站内相关:术语表 · Variables、创建样式、自动布局、更新日志。
核心概念 #
变量类型与集合 #
官方「变量总览」类文档说明:变量按类型存储不同取值(如颜色、数字、字符串、布尔等,以产品当前支持为准),并归入 Collection(集合) 管理。集合内可定义多个 Mode(模式),使同一变量在不同模式下有不同定义(例如 color/bg 在 Light / Dark 下各一套)。
向团队库发布变量等能力通常需要 Professional 及以上方案(官方写明的计划列表以帮助中心为准)。
应用到设计 #
可在属性面板将变量绑定到填充、描边、圆角、间距(含 Auto layout)、部分文字属性等。也可通过别名(alias)让一个变量引用另一个变量的定义,便于搭建语义层令牌。
扩展阅读(官方):
- Apply variables to designs (opens new window)(若链接变更请在 Help Center 搜索同名文章)
- Modes for variables (opens new window)
与 Styles(样式)的区别 #
Styles 适合封装一组外观(颜色填充、文本排版、效果、布局网格等)。Variables 更适合作为可绑定的单个值,并支持 Mode 切换与原型逻辑。官方专文:The difference between variables and styles (opens new window)。实践中二者常并存:样式管排版组合,变量管主题化 token。
见本站 创建样式。
进阶:原型与 API #
在 Professional 等方案上,可用 Set variable 等原型动作修改变量,结合表达式、多动作与条件分支,用更少 Frame 做出高保真交互。官方入口见变量总指南中的 Variables for advanced prototyping 一节。
开发者还可通过 Plugin API / REST API 读写变量,用于与代码库同步令牌。
Dev Mode 中的变量 #
工程师在 Dev Mode 中可查看应用到图层的变量详情与建议变量,并通过变量表浏览本地集合(见官方 Variables in Dev Mode)。
深度实战与设计系统落地 #
- Design Tokens 分层实战:学习如何通过 Primitive 与 Semantic 两层集合构建企业级变量系统,参见 Figma Variables 变量与 Design Tokens 体系落地指南。
- Variables 驱动变体与显隐:掌握用
String/Boolean/Number变量直接绑定组件变体切换、图层可见性与排版密度一键换态,参见 Figma Variables 驱动组件变体与图层显隐实战。 - Variables 驱动渐变、阴影与不透明度:学习如何将变量嵌套进
Color Styles渐变停点、Effect Styles阴影模糊与Layer Opacity,实现深浅色动态材质交付,参见 Figma Variables 进阶绑定渐变色停点、Effects 阴影模糊与图层不透明度实战。 - 老旧 Color Styles 无损升级为 Variables:掌握不拆毁历史业务文件的“换芯不换壳”三步过渡法与暗黑模式排障,参见 Figma 老旧 Color Styles 无损迁移到 Variables 变量实战。
- 模式配额破局与正交拆分:在 Starter(1 Mode)与 Pro(4 Modes)限制下如何拆分品牌、主题与断点集合控制成本,参见 Figma Variables 模式配额破局实战:突破 Starter 1 Mode 与 Pro 4 Modes 限制的多维集合正交拆分与成本选型指南。
- 低保真线框一键升级高保真:使用
Wireframe/Hi-Fi双模式语义变量实现需求原型无损换肤升级,参见 Figma 线框图与低保真产品原型快速搭建实战。 - 原生 JSON 互转与多品牌扩展:掌握原生 W3C DTCG JSON 导入导出与 Extended Collections 扩展合集,参见 Figma Variables 原生 JSON 导入导出与 Extended Collections 扩展合集实战。
- 中后台组件库对齐实战:将 Seed/Map/Alias 三层变量体系与 Ant Design 5.x、Element Plus、TDesign 对齐落地,参见 Figma 与 Ant Design 5.x / Element Plus / TDesign 中后台设计系统工程化对齐实战。
- 跨端桌面与地域主题切换:用
OS Mode一键切换 macOS/Windows 窗口控制与快捷键,或用Market Direction集合一键切换红涨绿跌/绿涨红跌,参见 Figma 跨端桌面应用 UI 设计系统实战 与 Figma 金融科技高密度 UI 设计系统实战。 - 医疗合规与物联网状态机:通过正交集合实现临床查房/暗室模式切换与患者隐私一键脱敏,或构建 IoT 设备在线/离线/OTA 状态机与 OLED 夜间模式,参见 Figma 智慧医疗高合规 UI 设计系统实战 与 Figma 智慧物联网(IoT / 智能家居)UI 设计系统实战。
- 跨境电商促销换肤与 Codegen 代码反查:用
Campaign_Theme一键切换日常常青与黑五 BFCM 促销视觉,或通过 Dev Mode Codegen 插件反查boundVariables生成企业私有组件代码,参见 Figma 跨境电商独立站高转化设计系统实战 与 Figma Dev Mode 自定义代码生成插件开发实战。 - 微前端令牌隔离与政务适老关怀模式:在微前端架构下为 Variables 配置
--mf-core-*命名空间防污染,或构建Care_Scale/Care_Color变量集合一键切换标准版与长辈高对比模式,参见 Figma 与微前端多团队设计系统架构实战 与 Figma 政务服务与适老化改造及信创桌面设计系统实战。 - 智能穿戴节能与线下双屏终端切换:构建
Watch_Display_Mode实现 OLED 纯黑省电、户外强光与 AOD 息屏常亮切换,或通过Kiosk_Env同步切换门店强弱光与收银主客双屏密度,参见 Figma 智能手表与可穿戴设备 UI 设计系统实战 与 Figma 线下自助终端与新零售点餐收银大屏 UI 设计系统实战。 - 空间计算光学玻璃与折叠屏响应式断点:构建
Spatial_Lighting实现 visionOS 明暗空间玻璃透光与高光描边自适应,或通过Responsive_Breakpoint变量集联动Wrap与布尔导航轨完成外屏、双折、三折叠与分屏无缝流转,参见 Figma 空间计算与 Apple Vision Pro(visionOS / XR)UI 设计系统实战 与 Figma 折叠屏手机与大屏平板分屏响应式自适应设计系统实战。 - 直播互动状态机与教育护眼阅读模式:构建
Live_Session_State动态控制电商带货、连麦 PK 与限时秒杀布局高度及槽位显隐,或通过Classroom_Theme一键切换暖纸护眼、标准机考与暗夜专注模式并联动公式矢量色彩,参见 Figma 互动直播间、电商带货与实时弹幕界面系统实战 与 Figma 在线教育、互动白板课堂与机考题库系统实战。 - 命名规范手册:规范化 Token 命名与代码映射规则,参见 Design Tokens 标准命名与结构对照手册。
- Variables 自动化脚本批量绑定实战:利用无代码
Automator流水线与Scripter画布内即时 TypeScript 脚本一键映射硬编码色值与间距令牌,参见 Figma Automator 与 Scripter 自动化脚本实战。 - Variables REST API 双向同步与容灾备份:通过 Enterprise 读写接口将 GitHub PR 中的 Token 变更回写 Figma,并构建每日 JSON 快照与
.fig本地冷备防灾体系,参见 Figma Variables REST API 双向同步与本地全量容灾备份实战。 - 间距、尺寸与 UI 密度变量实战:利用
Number(FLOAT)变量构建 4px/8px 阶梯、配置Scope防误绑隔离,并实现Compact / Default / Spacious三档密度一键切换与 Tailwind/CSS 映射,参见 Figma Variables 间距、尺寸与 UI 密度令牌(Spacing & Density Variables)工程化实战。 - 交互状态层(State Layers)与动态混色实战:利用透明状态变量与双层 Fill 堆栈复用
Hover / Pressed / Focus交互态并防破版输出Focus Ring,结合前端 CSScolor-mix()实现多主题零偏差交付,参见 Figma 交互状态层(State Layers)与语义状态色阶工程化实战。 - 代码交付对比:深入了解 Variables 如何在 Dev Mode 中导出给前端,参见 Figma 转 HTML 与前端代码交付实战。
- Variables 模式切换失效与断链排障:排查
Auto继承优先级锁死、六边形切换图标置灰、跨库别名断链与 Dev Mode 退化为裸 Hex 问题,参见 Figma Variables 模式切换失效、继承锁死与跨库断链深度排障实战。 - OKLCH 50–950 感知均匀色阶与变量语义映射:解决 HSL 黄色刺眼与蓝色发暗断层,按统一感知明度标尺生成 11 级色板与微色温中性灰并输出 CSS
oklch()与 Tailwind v4@theme,参见 Figma 感知均匀色阶(OKLCH / 50–950 11 级色板)从零构建与 Variables 语义映射实战。 - 动态字体缩放与无障碍大字版多模式压测:构建对标 iOS Dynamic Type 与 Android Font Scale(200%)的字号与行高变量阶梯,结合 Auto Layout Wrap 与弹性防截断重构,参见 Figma 动态字体缩放(iOS Dynamic Type / Android Font Scale)与无障碍大字版适配实战。
- APCA 感知对比度与系统高对比度模式:按 WCAG 3.0 APCA
Lc值标定色阶字重梯度,在 Variables 中新增High Contrast模式并输出 CSSprefers-contrast: more与 WindowsForced Colors边界保护,参见 Figma APCA 感知对比度与高对比度模式(Forced Colors / prefers-contrast)设计系统实战。 - 现代原生 CSS
light-dark()双色令牌同步:将浅深两列 Semantic Variables 映射为单行light-dark()函数与局部color-scheme反色容器,参见 Figma Dev Mode 对接现代原生 CSS 新标准工程化交付实战。 - 无障碍减少动态效果(
Motion_Tokens)双模式:构建Standard与Reduced模式控制时长、位移距离与循环装饰图层显隐,联动触觉反馈与三端prefers-reduced-motion代码交付,参见 Figma 减少动态效果无障碍动效降级与触觉反馈标注交付实战。 - Passkey 安全认证与调试状态变量(
Auth_Flow_State):利用布尔与枚举字符串变量驱动生物识别支持探测、异常降级提示与安全管理页面边界状态机,参见 Figma 无密码登录(Passkey / WebAuthn)与生物识别组件交付实战。 - 深浅色 Logo、插画与媒体图自动换肤:通过
String变量绑定组件变体与全矢量语义色板突破 Variables 不支持原生 Image 类型的限制,参见 Figma 深浅色主题(Light/Dark Mode)品牌 Logo、插画与媒体图自动切换实战。 - 跨倍率极细边框线宽令牌(
border/width/hairline):利用Number变量在Mobile_App (0.5px)与Desktop_Web (1px)间一键切换描边粗细并对齐Stroke width作用域,参见 Figma 0.5px 极细分割线与 Retina 亚像素防发虚实战。 - 渐变边框停点与媒体占位底色变量:将渐变描边停点绑定双模式语义色值并输出
mask-composite: exclude真透明圆角边框,或使用bg/media-placeholder配合ThumbHash与aspect-ratio实现暗黑模式零闪白与零 CLS 加载,参见 Figma 渐变边框与圆角裁剪工程化交付实战 与 Figma 渐进式图片加载占位与零抖动媒体交付实战。 - 动态 OG 分享卡主题变量与噪点纹理不透明度:在
1200×630Satori 分享卡片模板中用 Variables 联动深浅主题并压测截断文本,或将磨砂噪点层Layer Opacity绑定为Light/Dark双模式数值令牌,参见 Figma 动态 OG Image 模板与 @vercel/og 自动化生图实战 与 Figma 噪点纹理与 SVG feTurbulence 工程化交付实战。 - CSS Relative Color 动态派生状态色与变量库减负:仅在 Figma 中保留核心语义底色令牌,砍掉成百上千个冗余 Hover / Active / Subtle 变体,通过
oklch(from var(...) ...)在前端动态计算状态阶梯与多品牌换肤,参见 Figma Variables 主题色阶减负与 CSS Relative Color 相对颜色语法动态状态派生实战。 - Top Layer 遮罩令牌与原生表单主题极性同步:在 Semantic 集合中独立管理
color/surface/backdrop-modal与border/focus-ring/border/focus-halo双环令牌,并对接原生 HTMLPopover API、<dialog>及 CSScolor-scheme、accent-color与:focus-visible,参见 Figma 浮层弹窗对接原生 HTML Top Layer(Popover API 与 dialog)工程化交付实战 与 Figma 表单控件系统主题同步(color-scheme / accent-color)与焦点可见性交付实战。 - 选区反色令牌(
::selection)与指针/穿透交付契约:在 Semantic 集合中增加color/bg/selection与color/text/selection双模式令牌,解决深浅主题框选文字对比度失真,并与pointer-events: none/user-select/cursor交付契约对齐,参见 Figma 交互指针、点击穿透拦截与文本选中控制工程化交付实战。 - Variables 容器嵌套继承与 CSS
@container style()查询实战:正交拆分Context_Surface与Context_Density容器集合,锁死子组件Auto模式继承链,并在前端 1:1 映射为原生容器样式查询@container style(),彻底终结深层 Props 透传与局部反色主题覆盖冲突,参见 Figma Variables 模式嵌套继承对接现代 CSS 容器样式查询(@container style())工程化交付实战。 - Variables 数值/色标对接 CSS
@property类型化自定义属性实战:拆分进度数值与渐变色标变量并注册<percentage>/<angle>/<color>类型,实现环形渐变进度条、按钮渐变平滑悬停及深浅色渐变无缝过渡,参见 Figma 渐变与数值变量对接现代 CSS @property 类型化自定义属性工程化交付实战。 - Variables 输入模态集合与跨端触控热区实战:构建
Input_Modality(Pointer_FinevsTouch_Coarse)变量模式控制图标热区与行高,并在前端对接@media (hover: hover)与(pointer: coarse)消灭粘滞悬停与触屏漏操作,参见 Figma 交互组件变体与触控热区对接现代 CSS 交互能力媒体查询工程化交付实战。
建议练习 #
官方提供 Variables playground 等 Community 练习文件(链接见 Guide to variables (opens new window))。建议复制后对照本页概念动手绑定颜色与间距 Mode。
整理自 Figma Help Center,更新于 2026-11-02(Asia/Shanghai)。
核心手册与速查工具
高频手册与实用设计生产力工具直达常见问题与答疑 (FAQ)
高频疑难解析与避坑指南macOS 上主要使用 Command (⌘) 键,Windows 上对应 Ctrl 键;Option 键对应 Windows 的 Alt 键。建议使用快捷键 Ctrl + Shift + ?(Windows)或 Cmd + Shift + ?(Mac)随时调出内置快捷键助手。