样式变量迁移工具 Style Variable Migrator

About this plugin

【介绍】样式变量迁移工具（Style Variable Migrator）是专为 Figma 设计师打造的设计系统迁移插件。它能将文字样式（Text Styles）和本地变量（Variables）——包含变量集合、多模式配置及别名引用链——完整地从一个 Figma 文件迁移到另一个文件，帮助团队高效复用设计系统，告别繁琐的手动重建。【功能说明】文字样式迁移：完整迁移字体、字号、行高、字间距、段落缩进、文字大小写、文字装饰等全部属性变量集合迁移：保留集合名称、描述及多模式（Mode）结构，原样还原至目标文件变量完整迁移：支持 COLOR、NUMBER、FLOAT、STRING 四种变量类型，并正确处理变量别名（VARIABLE_ALIAS）引用别名链完整保留：采用两遍处理机制，先建立所有变量，再还原别名指向，彻底解决跨文件别名丢失问题冲突检测与处理：导入前自动检测名称冲突，支持覆盖或跳过策略，灵活控制迁移结果节点绑定更新：导入后可对当前页面节点重新绑定变量与文字样式，支持名称匹配与颜色数值双通道智能匹配【使用方法】在源文件中打开插件，点击「导出」将样式和变量导出为 JSON 数据复制全部 JSON 内容在目标文件中打开插件，将 JSON 粘贴至导入区域选择冲突处理策略（覆盖 / 跳过），点击「导入」导入完成后，可点击「更新绑定」自动重新绑定当前页面节点【注意事项】仅支持迁移本地文字样式和变量，不含组件库或外部引用的样式变量别名的被引用变量须同在导出数据中，否则该别名无法还原覆盖模式下，目标文件中同名变量集合及其所有变量将被删除并重建，请先备份「更新绑定」仅作用于当前页面节点，不跨页面操作建议迁移前备份目标文件，防止误操作造成数据丢失【Introduction】Style Variable Migrator is a Figma plugin built for seamless design system migration. It fully transfers text styles and local variables — including variable collections, multi-mode configurations, and alias reference chains — from one Figma file to another. Help your team efficiently reuse design systems and eliminate tedious manual rebuilding.【Function Description】Text Style Migration: Fully migrates all text style properties, including font family, size, line height, letter spacing, paragraph indent, text case, and text decorationVariable Collection Migration: Preserves collection names, descriptions, and multi-mode structures, restoring them exactly in the target fileComplete Variable Migration: Supports COLOR, NUMBER, FLOAT, and STRING variable types, with correct handling of VARIABLE_ALIAS referencesAlias Chain Preservation: Uses a two-pass processing mechanism — creates all variables first, then restores alias references — completely solving the cross-file alias resolution problemConflict Detection & Handling: Automatically detects name conflicts before import; supports overwrite or skip strategies for flexible migration controlNode Binding Update: After import, re-binds variables and text styles to nodes on the current page using intelligent dual-channel matching (name + color value)【How to Use】Open the plugin in the source file and click "Export" to export styles and variables as JSONCopy the full JSON contentOpen the plugin in the target file, paste the JSON into the import areaChoose your conflict resolution strategy (Overwrite / Skip) and click "Import"After import, optionally click "Update Bindings" to automatically re-bind nodes on the current page【Notes】Only local text styles and variables are supported; styles from component libraries or external references are not includedVariable aliases can only be restored if the referenced variables are also present in the same export dataIn overwrite mode, same-named variable collections and all their variables in the target file will be deleted and rebuilt — back up first"Update Bindings" only applies to nodes on the current page and does not operate across pagesIt is recommended to back up the target file before migration to prevent accidental data loss