figma中需通过tokens studio等插件建立结构化design tokens体系，经json标准化导出、style dictionary多平台编译、github双向同步及token gallery可视化预览，实现设计与开发变量统一维护。
如果您在Figma中构建设计系统，但发现颜色、间距、字体等变量难以统一维护并同步至开发环境，则可能是由于缺乏结构化的Design Tokens管理机制。以下是实现Design Tokens定义、可视化管理及跨平台同步的进阶操作步骤：
一、使用Figma插件建立Token基础结构
通过官方或社区验证的插件（如Tokens Studio、Spline Tokens或Zeroheight Sync）在Figma内创建可导出的Token层级结构，使设计变量具备命名规范、类型标识与分组逻辑，为后续代码映射提供语义化基础。
1、打开Figma文件，点击右上角“Plugins”按钮，搜索并安装Tokens Studio for Figma插件。
2、运行插件后，在左侧侧边栏选择“Create new token set”，输入名称如core-tokens，并设置作用域为global。
3、在Token编辑界面中，依次添加color、spacing、typography三类Token组，每组下以BEM式命名规则录入具体值，例如color-primary-500对应#3b82f6。
4、为每个Token指定type（如color、dimension、fontFamily），确保导出时能被下游解析器识别数据类型。
二、配置JSON输出与格式化规则
Design Tokens需以标准化JSON Schema输出，才能被Style Dictionary或Theo等工具消费；手动调整导出结构可规避类型歧义与嵌套错误，提升代码端解析稳定性。
1、在Tokens Studio插件中进入“Export”面板，点击“Configure export format”。
2、将输出格式切换为JSON (Style Dictionary compatible)，并勾选“Flatten nested tokens”选项。
3、在“Advanced options”中启用“Use semantic naming for aliases”，确保引用别名（如color-border-default）不展开为原始值，保留语义链路。
4、点击“Export to file”，保存为tokens.json，确认文件根对象包含source与settings两个顶层键。
三、集成Style Dictionary实现多平台代码生成
Style Dictionary作为跨平台Token编译工具，可将Figma导出的JSON转换为SCSS变量、React Hook、Swift UIColor等目标格式，消除设计与开发间的格式鸿沟。
1、在项目根目录执行命令初始化Style Dictionary：npx style-dictionary init，生成style-dictionary.config.js。
2、修改配置文件，在source数组中添加路径./tokens.json，在platforms中定义css与js两个输出平台。
3、为css平台设置transformGroup: 'css'，为js平台设置transformGroup: 'js'，确保单位转换（如rem→px）、颜色格式（HEX→RGB）符合前端规范。
4、运行npm run build，自动生成build/css/variables.css与build/js/tokens.js，供样式表与组件直接引用。
四、启用Figma ↔ 代码双向同步工作流
借助Tokens Studio的Sync功能或自建Webhook监听机制，可在Figma Token更新时自动触发Style Dictionary重建与Git提交，保障设计系统版本与代码仓库严格一致。
1、在Tokens Studio插件中点击“Sync”标签页，选择“Connect to GitHub”，授权访问目标仓库。
2、设定同步规则：将core-tokens Token Set绑定至仓库中src/tokens/foundation.json路径，并启用“Auto-commit on change”。
3、在Figma中修改任意Token值（如将spacing-4从1rem改为16px），插件自动检测变更并推送新版本JSON至GitHub。
4、配置GitHub Actions工作流，在src/tokens/路径变更时执行npx style-dictionary build，并将生成文件提交至dist/分支。
五、在Figma中嵌入Token实时预览组件
利用Figma的变体（Variants）与属性（Properties）功能构建Token展示画板，使设计师无需跳转插件即可查看Token命名、值、用途及对应UI示例，强化团队认知对齐。
1、新建页面命名为Token Gallery，使用矩形框+文本组合创建Color Token Card组件，设置主色块填充为color-primary-500，下方标注名称与HEX值。
2、将该组件转为变体，按type属性（primary / secondary / success）创建不同状态，并为每种状态绑定对应Token值。
3、在组件属性面板中添加usage文本属性，手动填入典型使用场景（如“按钮背景色”、“标题描边”），支持筛选与搜索。
4、发布组件到团队库，所有成员插入该组件时自动继承最新Token定义，且点击实例可快速定位至Tokens Studio编辑界面。
