应启用Tokens Studio语义分组导出、预定义Schema约束命名、Custom Transform脚本重写结构、分离主题变量导出通道，以解决CSS变量结构松散、命名冗余等问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在figma中导出css变量后发现生成的代码结构松散、命名冗余、嵌套过深或类型混杂，这通常源于tokens studio插件默认导出策略未适配项目语义规范。以下是解决此问题的具体方法：一、启用Tokens Studio的语义分组导出模式
Tokens Studio默认将所有变量扁平化输出为单一JSON对象，导致颜色、间距、字体等混合排列，缺乏层级与分类逻辑。启用语义分组可强制按设计系统维度组织变量结构。
1、打开Tokens Studio面板，点击右上角Settings齿轮图标。
2、在Export Settings中，将Grouping Strategy设为“By Category”而非“Flat”。
3、勾选“Preserve Token Type Hierarchy”，确保color、typography、spacing等顶层键被保留。
立即学习“前端免费学习笔记（深入）”；
4、导出前点击Preview，确认输出结构类似：{"color": {"primary": {"500": {"value": "#4F46E5"}}, "background": {"surface": {"value": "#FFFFFF"}}}, "spacing": {"xs": {"value": "4px"}}。
二、预定义Token Schema约束变量命名与格式
Tokens Studio支持通过JSON Schema校验并标准化变量命名规则，避免出现c123、bg_01等无意义标识符，确保导出即符合Ant Design或Design System命名约定。
1、在Tokens Studio左侧导航栏点击“Schemas”，新建schema文件命名为design-system-schema.json。
2、粘贴标准Schema片段，强制color类变量必须含语义后缀（如-500、-surface）、spacing类必须为数字单位（px/rem）。
3、在Variables面板中，为每个变量集绑定该schema，绑定后非法命名变量将标红并禁止导出。
4、批量重命名现有变量：选中全部color变量 → 右键Apply Naming Convention → 选择“Semantic Color Scale”，自动转为primary-500、error-400等格式。
三、使用Custom Transform脚本清洗导出内容
Tokens Studio内置Custom Transform功能，允许插入JavaScript脚本对原始token数据进行结构重写，适用于将Figma变量映射为Ant Design兼容的CSS变量前缀格式（如--ant-color-primary）。
1、进入Export Settings → Custom Transform → 点击“Add Script”。
2、输入转换逻辑：遍历所有color节点，将key路径color.primary['500']重写为CSS变量名--ant-color-primary-500。
3、对number类变量（如spacing.xs），添加单位转换：若原始值为4，输出值设为'0.25rem'（按1rem=16px换算）。
4、启用“Transform Before Export”，导出时自动注入transformed变量，无需手动二次处理。
四、分离主题变量与基础变量导出通道
当项目需同时支持light/dark主题及多密度模式（compact/comfortable）时，Tokens Studio默认合并所有变量会加剧混乱。应拆分为独立导出任务，确保各通道变量无交叉污染。
1、在Variables面板中，创建三个变量集：BaseTokens（基础色、字号）、LightTheme、DarkTheme。
2、为LightTheme和DarkTheme分别设置Conditional Values，绑定同一布尔变量isDarkMode。
3、在Tokens Studio中新增两个Export Config：一个仅勾选BaseTokens + LightTheme，导出light.css；另一个仅勾选BaseTokens + DarkTheme，导出dark.css。
4、导出结果中，light.css仅含--ant-color-bg-surface: #FFFFFF；dark.css中对应变量值为#1E1E1E，完全隔离。
