figma设计稿自动化语言翻译需安装localize插件、准备utf-8编码json映射文件、运行插件批量替换文本及图层名、通过github actions实现ci/cd同步、结合figma变量动态切换语言。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在Figma中处理多语言设计稿时需反复手动修改文本，导致效率低下且易出错，则可能是由于缺乏对设计元素中文本内容的批量、上下文感知式替换能力。以下是实现Figma设计稿自动化语言翻译的具体操作步骤：
一、安装Localize插件
Localize是一款专为Figma设计稿内文本内容提供多语言批量替换的开源插件，支持JSON格式的翻译映射表驱动，可精准识别图层名称、文本节点内容及组件实例中的可翻译字段。它不修改原始设计结构，仅对指定文本属性执行安全覆盖。
1、打开Figma桌面端或网页版，进入任意设计文件。
2、点击右上角“Plugins”按钮，选择“Search plugins”。
3、在搜索框中输入Localize，从结果中选择官方认证插件（作者为“localize-figma”）。
4、点击“Install”完成安装，插件将自动出现在“Plugins → Installed”列表中。
二、准备翻译映射JSON文件
该步骤用于定义源语言（如英文）与目标语言（如中文）之间的精确对应关系。Localize仅替换JSON中明确声明的键值对，未声明的文本保持原样，确保安全性与可控性。
1、新建纯文本文件，命名为translations-zh.json。
2、按标准JSON格式编写键值对，例如：
{"File": "文件", "Export": "导出", "Auto Layout": "自动布局", "Constraints": "约束条件"}
3、保存文件至本地任意路径，确保文件编码为UTF-8，无BOM头。
三、运行Localize执行批量替换
插件启动后将扫描当前选中图层或整个页面内的所有文本图层（Text Nodes）及含文本属性的组件实例，并依据JSON映射表逐项比对并替换内容，保留原有字体、字号、颜色等样式属性不变。
1、在Figma画布中选中需要翻译的目标图层组，或直接按Ctrl+A全选页面内容。
2、再次点击“Plugins” → “Installed” → “Localize”。
3、在弹出窗口中点击“Choose JSON file”，上传前述准备好的translations-zh.json。
4、勾选“Replace layer names”（同步更新图层命名）和“Apply to instances”（作用于组件实例）选项。
5、点击“Run Localize”，等待几秒后所有匹配文本将被自动替换为中文。
四、使用GitHub Actions实现CI/CD式自动同步
当设计系统持续迭代时，可将翻译JSON文件托管于GitHub仓库，并通过Actions监听文件变更，自动触发Figma API调用，将最新翻译注入指定Figma文件。此方式适用于团队级标准化流程，无需人工干预每次更新。
1、在GitHub仓库根目录创建.github/workflows/localize-sync.yml。
2、配置workflow监听translations-zh.json文件的push事件。
3、在steps中调用figma-api-action，传入Figma文件ID、节点ID及JSON内容。
4、设置Figma Personal Access Token为仓库Secret，确保API调用权限。
五、启用Figma变量（Variables）结合Localize动态切换
Figma原生变量功能支持创建语言维度变量集，Localize可读取该变量集输出的当前语言标识，并联动加载对应JSON文件。此方案使同一份设计稿支持多语言预览，且无需重复替换操作。
1、在Figma中进入“Assets → Variables”，新建变量集命名为Language。
2、添加字符串类型变量，如“ui_file”、“ui_export”，其值设为英文默认文案。
3、在Localize插件设置中启用“Use Figma Variables as source”，并指定该变量集。
4、切换变量值为中文后，运行Localize，插件将自动提取变量值并反向映射至画布文本。
