figma中variables需通过collection实现自动化分组与语义管理：一、创建tokens/core、theme、state三个collection；二、用color/primary/500等斜杠命名自动归类；三、用tag跨collection筛选；四、用tokens sync插件批量校验同步；五、按collection导出独立json schema文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在Figma中使用Variables功能时发现变量命名杂乱、归属不清、跨项目复用困难，或无法快速识别颜色/间距/状态变量的语义层级，则很可能是缺乏基于Collection的自动化分组机制。以下是解决此问题的步骤：
一、理解Collection与Variable集的本质区别
Variable集（Variable Set）仅提供扁平化容器，不支持嵌套与元数据标记；而Collection是Figma官方为Design Tokens规范化提出的结构化组织单元，可绑定描述、标签、分类路径及导出规则，是实现自动化分组的前提基础。未启用Collection会导致所有变量混杂在同一列表中，无法按主题、模块、生命周期进行筛选与批量操作。
1、打开Figma文件，点击左侧面板底部Variables图标。
2、在Variables面板右上角点击⋯ More options，选择Create Collection。
3、命名为Tokens/Core，勾选Include in token exports选项。
4、重复创建Tokens/Theme与Tokens/State两个Collection，分别用于存放基础值、明暗主题映射、交互状态变量。
二、通过命名前缀触发自动Collection归类
Figma会根据变量名称中的斜杠（/）自动将其分配至对应Collection路径，无需手动拖拽。该机制依赖严格命名规范，是实现“零配置自动化分组”的核心逻辑。若变量名不含斜杠或格式错误，将默认落入未归类集合，造成管理混乱。
1、在Tokens/Core Collection内点击+ Add variable。
2、输入名称为color/primary/500，类型选Color，值设为#4F46E5。
3、再添加spacing/base（Number类型，值16）与radius/sm（Number类型，值4）。
4、确认所有变量名称均采用category/subcategory/name三级结构，且全部斜杠为英文半角。
三、利用Filter与Tag实现跨Collection动态筛选
当变量数量超过50个后，单纯依赖Collection树形展开效率低下。Figma支持对Collection内变量添加Tag，并通过顶部Filter栏组合筛选，从而突破单Collection边界，实现按用途、平台、生效范围等维度交叉检索。
1、在Variables面板中右键点击color/primary/500变量，选择Add tag。
2、输入Tag名used-in-web，回车确认。
3、对Tokens/Theme中的bg/surface变量，添加Tagdark-mode-only。
4、在Variables面板顶部Filter框中输入tag:used-in-web，系统将高亮显示所有带该Tag的变量，无论其所属Collection。
四、通过Plugin实现Collection级批量同步与校验
人工维护多Collection变量易导致命名偏移、类型错配或缺失。借助Figma插件Token Studio或Tokens Sync，可设定规则自动扫描全文件变量，按正则匹配归入指定Collection，并报告冲突项（如相同路径下存在Number与Color双类型变量）。
1、安装插件Tokens Sync，运行后选择Scan All Variables。
2、在规则配置中设置：路径匹配^color/.+ → 自动归入Tokens/Core；路径匹配^is.+$ → 自动归入Tokens/State。
3、点击Apply Rules，插件将列出待移动变量清单，勾选后执行批量迁移。
4、运行Validate Collections，检查是否存在unclassified variables或duplicate paths。
五、导出时按Collection生成独立JSON Schema
开发集成阶段若将全部变量导出为单一JSON，会导致前端解析冗余、主题切换耦合度高。Figma支持按Collection粒度导出，每个Collection生成符合OpenAPI Token Schema标准的独立文件，便于开发按需引入、Tree-shaking与环境隔离。
1、在Variables面板中点击Export tokens按钮。
2、取消勾选Export all variables，改为勾选Tokens/Core、Tokens/Theme、Tokens/State三个Collection。
3、为每个Collection单独设置导出格式：Tokens/Core → core-tokens.json；Tokens/Theme → theme-tokens.json；Tokens/State → state-tokens.json。
4、点击Download，确认三个文件均包含$schema字段且collection属性值与源名称一致。
