Figma Automator 与 Scripter 自动化脚本实战:无代码批量绑定 Variables、千级图层统一重构与零配置 DesignOps 批处理指南
在大型设计系统重构或跨版本改版中,设计师与 DesignOps 工程师经常会遇到单靠手动操作根本无法按期交付的“脏活累活”:
- 历史裸值批量转变量:老项目里散落着上千个直接写死
#2563EB、16px内边距与8px圆角的旧画板,需要全部匹配绑定到最新的 Figma Variables(变量) 语义令牌; - 多层级画稿结构清洗:需要将几百张用普通
Group堆出来的老旧卡片统一转为 Auto Layout 自动布局,并批量套用间距、填充与语义命名规范; - 定制化规范巡检与标注:团队内部需要按特定规则(如“仅对名称以
btn-开头的 Frame 补充圆角标注,或将所有11px文本纠偏为12px”)执行批处理。
面对这类高度定制化的重复工程,现成的通用社区插件(如选层与样式批量工具,详见 Figma 2026 效率插件实战矩阵)往往无法把多个动作串联成一条流水线;而从零搭建一个带 manifest.json 的独立插件又显得过于笨重。此时,Automator(无代码可视化动作编排) 与 Scripter(画布内即时 TypeScript 脚本运行器) 就是最具性价比的零配置自动化方案(插件运行基础见 在文件中运行插件)。
一、Figma 五大批量处理方案选型与能力边界对比 #
动手搭建自动化流程前,先对照下表判断当前需求究竟适合直接用原生快捷键,还是交给 Automator、Scripter 或自研独立插件:
| 方案维度 | 原生批处理(⌘+R / ⌘+F / Multi-edit) | 通用单一插件(Similayer / Batch Styler) | Automator(无代码动作流) | Scripter(画布内即时脚本) | 独立自研插件(Manifest + UI) |
|---|---|---|---|---|---|
| 使用门槛 | 零门槛,快捷键直达 | 零门槛,勾选菜单即可 | 低门槛,拖拽积木节点拼条件与动作 | 中门槛,需会基础 JS/TS 与 Figma Plugin API | 高门槛,需配构建环境与团队私有发布 |
| 多步骤串联能力 | 弱(只能单步改名或同步编辑) | 弱(选层后仍需手工操作) | 强(可把“筛选 → 转布局 → 绑变量 → 重命名”串成一键动作) | 极强(支持完整循环、条件判断、正则与异步变量映射) | 极强(支持外部网络请求与复杂可视化面板) |
| Variables 变量绑定 | 仅支持选区逐项手动点选 | 部分支持样式,不支持复杂色值映射规则 | 支持(可读取本地变量并批量绑定基础属性) | 满分支持(可通过 setBoundVariable 精确映射任意别名与模式) | 满分支持 |
| 团队复用与分享 | 仅限个人当下会话 | 需每人各自配置条件 | 可导出 .automator JSON 文件发给团队导入一键复现 | 可导出代码片段存入团队文档或 Git 仓库随时粘贴执行 | 通过组织插件库集中分发 |
| 典型适用场景 | 批量改图层名、跨画板改文案(见 批量治理实战) | 跨页面选出同色字号图层并改字体 | 设计师日常规范化卡片、一键搭好标准容器骨架 | 存量老设计稿按字典自动迁移 Variables、批量文本字体容错修复 | 需要长期对接 GitHub、API 或自定义代码生成器 |
二、实操一:用 Automator 搭一条“老旧卡片一键标准化”无代码流水线 #
当团队需要将散乱的 Group 卡片批处理为符合 Dev Mode(开发模式) 交付标准的弹性容器时,按以下四步在 Automator 中构建可复用的无代码工作流:
第 1 步:限定选区范围与前置安全过滤 #
- 在画布中选中需要改造的目标卡片(建议首次试跑先框选
5~10个画板验证结果); - 按
⌘ + /(Windows 为Ctrl + /) 呼出 Quick Actions 运行Automator,点击New Automation新建动作流; - 在动作流首节点添加
Get Selection(获取当前选区),并紧接一个Filter(条件过滤) 节点:设置仅保留Type is Frame or Group,同时排除锁定图层(Locked is false)与组件实例(Type is not Instance),防止意外破坏只读组件实例结构。
第 2 步:串联布局重构与 Variables 变量绑定动作 #
在过滤节点下方依次拖拽挂载以下动作积木(变量命名规范可对照 Design Tokens 标准命名与结构对照手册):
Add Auto Layout:将普通Group或自由Frame转为垂直弹性容器,开启Clip content按需裁剪;Set Spacing / Padding:分别选择预设的Number变量(如spacing/md (16)与spacing/sm (8)),直接将容器内边距与子项间距绑定到团队变量,而非填入硬编码数字;Set Corner Radius:绑定圆角变量radius/md (12);Set Fill:将卡片底色绑定为语义令牌surface/card-default(确保后续切换 Dark Mode 自动反色);Rename Layer:末尾追加重命名动作,将混乱的Group 128统一规范为Card/Standard。
第 3 步:保存快捷指令并团队共享 #
点击右上角 Run 一键执行,所有选中的旧卡片会在 1 秒内完成从散乱编组到 Variable 弹性组件的蜕变。保存该动作流并导出配置文件发给设计组同事,新人也能直接导入复用,彻底统一画稿工程规范。
三、实操二:用 Scripter 10 行脚本按色值自动绑定 Color Variables #
无代码工具在遇到“根据旧色号智能查表对应不同语义变量”或“处理混合字体(Mixed Fonts)”等逻辑分支时往往力不从心。借助社区免费脚本沙盒插件 Scripter,你可以直接在画布内编写并运行 Figma 原生 TypeScript,无需创建工程目录或编译打包。
场景 1:把选区内的硬编码十六进制色值自动映射为本地 Color Variables #
假设旧稿中存在大量未绑定变量的裸色 #2563EB(主品牌色)与 #0F172A(主文字色),需要批量重连到本地变量 color/brand-primary 和 color/text-primary:
- 启动
Scripter新建脚本,先创建一张“目标变量名 → 十六进制色值”的映射逻辑; - 粘贴以下真实调用 Figma Plugin API 的核心代码片段并点击
Run:
// 在 Scripter 中运行:将当前选区及子节点的硬编码纯色自动绑定到匹配的 Color Variables
const selection = figma.currentPage.selection;
if (selection.length === 0) {
figma.notify("请先选中至少一个画板或图层");
} else {
const localColorVars = await figma.variables.getLocalVariablesAsync("COLOR");
// 构建常用语义变量索引(按变量名称匹配)
const varMap = new Map(localColorVars.map(v => [v.name, v]));
// 定义旧 Hex 到目标 Variable 名称的映射字典(全大写 6 位 Hex)
const hexToVarName: Record<string, string> = {
"#2563EB": "color/brand-primary",
"#0F172A": "color/text-primary",
"#FFFFFF": "color/surface-default",
};
const toHex = (c: RGB) =>
"#" + [c.r, c.g, c.b]
.map(x => Math.round(x * 255).toString(16).padStart(2, "0").toUpperCase())
.join("");
let updatedCount = 0;
for (const root of selection) {
const nodes = "findAll" in root ? [root, ...root.findAll()] : [root];
for (const node of nodes) {
if (!("fills" in node) || !Array.isArray(node.fills)) continue;
const newFills = node.fills.map(paint => {
// 跳过已绑定变量、非纯色填充,以及处于组件实例内部不可覆写属性的保护逻辑
if (paint.type !== "SOLID" || paint.boundVariables?.color) return paint;
const hex = toHex(paint.color);
const targetName = hexToVarName[hex];
const targetVar = targetName ? varMap.get(targetName) : undefined;
if (!targetVar) return paint;
updatedCount++;
return figma.variables.setBoundVariableForPaint(paint, "color", targetVar);
});
try {
node.fills = newFills;
} catch {
// 个别锁定或受限实例子图层跳过,避免中断整批执行
}
}
}
figma.notify(`已完成变量重绑定,共更新 ${updatedCount} 处纯色填充`);
}
场景 2:批量统一文本框为 Auto Height 之前的安全字体预加载 #
用脚本批量修改文本内容或调整文本 textAutoResize = "HEIGHT" 时,如果不先加载该文本框内部实际用到的全部字重(尤其是中英混排时存在 figma.mixed 混合字体),脚本会直接抛出错误中断。标准防崩溃写法如下:
// 批量将选区内 Fixed 固定高度文本框安全转为 Auto height 自适应高度
const textNodes = figma.currentPage.selection
.flatMap(n => ("findAllWithCriteria" in n ? n.findAllWithCriteria({ types: ["TEXT"] }) : n.type === "TEXT" ? [n] : []));
for (const text of textNodes) {
if (text.fontName === figma.mixed) {
// 若段落内混用了多个字重,遍历所有字符片段并逐一加载字体
const fonts = text.getRangeAllFontNames(0, text.characters.length);
await Promise.all(fonts.map(f => figma.loadFontAsync(f)));
} else {
await figma.loadFontAsync(text.fontName);
}
text.textAutoResize = "HEIGHT";
}
figma.notify(`已安全转换 ${textNodes.length} 个文本框为 Auto Height`);
四、企业级自动化批处理安全守则与高频报错排查 #
自动化脚本的威力在于“1 秒修改上千个节点”,但一旦选错范围或误触只读对象,破坏力也同样成倍放大。执行前务必遵守安全基线,遇到报错按以下矩阵快速定位(更多异常详见 Figma 常见报错与疑难故障诊断手册):
| 高频报错或异常现象 | 底层原因定位 | 标准化预防与修复动作 |
|---|---|---|
脚本运行一半崩溃,提示 Cannot write to node with unloaded font | 修改文本属性或字符前,未调用 figma.loadFontAsync(),或忽略了 figma.mixed 混排字重 | 任何涉及 TEXT 节点的写操作前,必须判断 text.fontName === figma.mixed 并加载 getRangeAllFontNames() 返回的全部字体 |
批处理修改边距或圆角失败,报错 Cannot modify property on instance child | 脚本试图在组件实例(INSTANCE)内部子节点上增删图层或强行改动结构性 Auto Layout 间距 | 过滤节点时判断并跳过主组件外不可结构化修改的实例内部节点;确实需要统一改间距的,应当直接修改其源 COMPONENT 主组件 |
| 运行整页遍历脚本时,画布卡死甚至触发 80% 内存红线崩溃 | 使用 figma.root.findAll() 全文件无差别扫描数万节点,撑爆 32 位 Wasm 2GB 堆内存 | 严禁直接扫全文件!优先用 figma.currentPage.selection 限定选区,或使用性能更高的原生过滤 API findAllWithCriteria({ types: [...] }) 分批执行 |
脚本跑完后发现效果不对,按 ⌘ + Z 撤销发现只撤回了一半或找不到原稿 | 批量脚本耗时较长或嵌套循环多次触发提交历史,导致撤销步数碎片化 | 铁律:跑任何高危批量脚本前,先在 版本历史记录(Version History) 手动保存一个带命名里程碑的快照(如 Before Batch Var Migration),翻车可秒级整页无损回滚 |
延伸阅读与规范参考
若需要将已绑定的本地 Variables 进一步同步至 GitHub 或生成 CSS/Swift/Kotlin 代码字典,可参考 Variables 入门 与 批量重命名图层指南;需要了解如何通过快捷键极速串联插件动作,可查阅 全平台 Figma 快捷键终极速查字典。
核心手册与速查工具
高频手册与实用设计生产力工具直达常见问题与答疑 (FAQ)
高频疑难解析与避坑指南完全不需要。绝大多数核心功能在免费 Starter 计划中均可完整体验与实操练习,无需额外付费购买付费团队版。