figma ai v2.4导出json失败的根本原因是变量组命名未遵循语义规则：必须以color_、space_、text_、radius_、border_之一开头，全英文、无空格，子项用小驼峰；否则ai跳过该组，导致json缺失category字段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在Figma中使用AI v2.4版本创建变量组（如颜色、间距、文字样式）时，发现导出的JSON文件里变量名混乱、层级缺失、无法被Style Dictionary或Theo识别，问题根源往往在于变量组命名未遵循AI可解析的语义结构。Figma AI v2.4对变量组名称有明确的语法偏好：它会将含下划线的前缀自动识别为分类标识，将驼峰式子项视为可提取值，而空格、中文或特殊符号会导致导出中断或字段丢失。
变量组命名必须满足AI解析前提
AI v2.4在扫描变量组时，仅信任以特定前缀开头、不含空格且全英文的名称。若命名为“主色系”或“Spacing 8px”，AI将跳过该组，不纳入tokens导出范围。
第一步：在左侧资源面板（Assets → Variables）中，点击“+ Add variable set”新建变量组。
第二步：输入组名时，【必须以color_、space_、text_、radius_、border_之一开头】，例如color-primary、space-layout、text-heading-lg、radius-card、border-input。
第三步：组内变量名禁用空格与连字符，使用小驼峰格式，如primary500、baseXs、h1Bold、sm、defaultSolid——AI会据此自动推断类型与层级。
第四步：避免嵌套同名变量组，例如不要同时存在color-primary和color_primary；AI v2.4会将后者识别为独立组而非子集，导致导出JSON中重复键冲突。
启用Dev Mode并导出结构化变量JSON
Dev Mode是Figma原生支持的变量导出通道，v2.4版本已优化对自定义前缀组的识别逻辑，无需插件即可输出带category字段的合规JSON。
点击右上角“Design”旁的“Dev Mode”开关，确保其处于开启状态。
在左侧资源面板中，展开Variables → 找到你刚创建的变量组（如color-primary），点击右侧三点菜单 → “Export as JSON”。
导出文件名为{变量组名}.json，内容中将包含"category": "color"、"type": "color"等字段——这是AI v2.4自动注入的元数据，【若导出JSON中无category字段，说明组名未匹配前缀规则】。
批量校验与修复变量组命名
当项目已有数十个变量组但命名杂乱时，手动重命名效率极低。Figma v2.4支持通过AI指令批量修正，前提是原始命名中保留了可识别的语义线索（如含“btn”“bg”“text”等词）。
方法一：使用内置AI重命名指令
在变量面板空白处右键 → “Rename variable sets with AI”。
输入Prompt：“将所有含‘bg’的变量组重命名为color-surface-{后缀}，含‘text’的重命名为text-{后缀}，含‘gap’的重命名为space-{后缀}，全部转为小写字母加短横线格式”。
方法二：运行MCP Server校验脚本
在Cursor等支持MCP的IDE中执行：run validate_variable_naming --file-id=abc123xyz --strict-mode=true。
该命令会扫描全部变量组，标记出不符合color_/space_/text_前缀的条目，并生成修复建议清单，例如：“border-main → border-main”（合规），“spacing-16 → space-layout”（需重命名）。
