Figma 企业级设计系统命名规范全解析:图层结构、斜杠(/)分组、组件属性与 Variables Token 命名约定实战
在团队协作的早期,很多设计师觉得“只要视觉稿好看,图层叫 Rectangle 128 还是 Frame 45 无所谓”。但当项目进入迭代期或沉淀为企业级设计系统后,混乱的命名会立刻引发连锁灾难:切换按钮变体时自定义文案突然被清空、在组件库里找一个图标要翻十几层平铺列表、批量导出切图时全堆在一个文件夹里重名覆盖,甚至连研发在 Dev Mode 和 AI 编程工具里读取到的代码结构也满是无意义的 div 嵌套。
在 Figma 中,命名绝不只是“视觉洁癖”,而是直接驱动界面检索、实例替换、切图归档、动效补间与前端代码映射的底层元数据(Metadata)。本文将拆解一套可直接落地的 Figma 企业级命名规范体系,覆盖从画布底层图层到设计令牌(Design Tokens)的全链路约定。
一、全链路命名对照表:不同资产用什么命名法? #
Figma 中各类资产的服务对象不同(设计师在面板查阅 vs 系统文件系统导出 vs 前端代码引擎解析),因此切忌“全站一刀切”,而应按场景选用最匹配的命名格式:
| 资产层级 | 推荐命名格式 | 标准示例 | 核心工程作用与避坑重点 |
|---|---|---|---|
| Page 页面 | 符号前缀 + 英文/中文模块名 | ✅ 交付定稿、🧩 Components | 清晰区分评审区、交付区与草稿区(架构见 文件目录与页面规范) |
| 业务画板(Frame) | 模块-页面-状态(语义化) | Checkout-OrderConfirm-Default | 方便研发检索与原型连线识别,禁止保留 iPhone 16 - 1 默认名 |
| 内部结构容器 | Kebab-case / 语义中文 | card-header、action-bar | 便于在图层面板快速读懂 Auto Layout 层级结构,对应前端 DOM 结构 |
| 主组件(Component) | PascalCase + 斜杠分组 | Button / Primary、Input / Search | / 斜杠自动在 Assets 面板与 Swap Instance 中生成树状折叠菜单 |
| 组件内部子图层 | 跨变体统一结构名 | Label、Leading Icon、Container | 切换变体时能否保留用户修改过的文案和图标颜色,全靠子图层同名 |
| 私有辅助组件 | _ 或 . 英文前缀 | _BaseButton、.Internal-Cell | 发布团队库时自动隐藏,防止业务设计师误调用底层原子结构 |
| Design Tokens(Variables) | Kebab-case + / 分组 | color/surface/brand、space/md | 同步映射 CSS 变量与多端代码(规范见 Design Tokens 命名手册) |
| 切图导出(Export) | 小写下划线(Snake_case) | ic_24_arrow_right、img_empty_cart | 兼容 iOS Xcode 与 Android Drawable 资源命名(严禁中文、空格与中划线) |
二、实操一:用斜杠(/)分组精确控制组件目录树与导出文件夹 #
Figma 对名称中的正斜杠 / 有两项极其核心的原生解析机制,熟练掌握后能省去大量手动整理工作:
1. 控制组件库与样式的折叠层级 #
- 建立“分类 / 子类 / 名称”三段式结构:
- 在 组件与实例指南 中,如果你将两个组件分别命名为
Navigation / TopBar / Default和Navigation / TopBar / Search,左侧 Assets 面板以及右侧属性栏的 Swap Instance(替换实例) 下拉框会自动收拢成Navigation → TopBar多级菜单,而不是杂乱地堆在一屏里; - 层级控制原则:建议最多不超过 3 级斜杠(如
大类 / 组件名 / 细分形态),超过 4 级会导致设计师在弹出菜单里点击路径过深,降低拼图效率。
- 在 组件与实例指南 中,如果你将两个组件分别命名为
- 区分“组件名分组”与“变体属性(Variants)”:
- 错误示范:把同一按钮的三种状态分别拆成
Button / Primary / Default、Button / Primary / Hover、Button / Primary / Disabled三个独立主组件; - 正确示范:只建一个主组件
Button,在 组件变体(Variants) 中用属性表达状态(如Type=Primary, State=Hover, Size=Medium)。斜杠用于切分不同组件品类,属性用于管理同一组件的维度变化。
- 错误示范:把同一按钮的三种状态分别拆成
2. 利用斜杠自动生成切图导出子目录 #
当你在图层名称中加入斜杠并配置 Export 导出预设 时,Figma 会在本地导出 ZIP 时自动把斜杠前的内容创建为真实系统文件夹:
- 例如图层命名为
icons/24/ic_home并导出 SVG,解压后会自动生成icons/24/ic_home.svg; - 安全警告:切图图层绝对不要随意在名称里包含日期或版本号斜杠(如
banner/2026/11/19),否则研发拿到压缩包后会发现里面套了四五层冗余空目录。
三、实操二:图层同名同构原则与批量正则重命名 #
为什么切换组件变体时,设计师改好的按钮文字突然变回了默认的 Button?或者做原型转场时,本该平滑移动的卡片突然退化成了生硬淡入淡出?80% 的原因都是变体或画板之间的子图层命名不一致。
- 执行“跨变体同构命名”:
- 同一个 Component Set 下的所有变体,内部核心节点必须保持名称完全一致、嵌套深度一致(深入排查见 组件变体切换覆盖失效治理);
- 图标组件特例:所有线性或面性图标母版内部的矢量路径层,建议统一命名为
Vector(或Icon Shape),并合并为单一扁平图层。这样在按钮中替换不同图标时,外部绑定的主色或反白文字变量才能 100% 自动继承而不跳回初始黑色。
- 使用
⌘ + R/Ctrl + R进行批量正则治理:- 选中需要整理的一批图标或图层,按快捷键打开 批量重命名弹窗;
- 统一加前缀:在 Rename to 栏输入
ic_24_后点击下方的 Current name(占位符$&),瞬间把所有选中图标加上规范前缀; - 正则去空格与替换符号:在 Match 栏输入
\s+(匹配一个或多个空格),在 Replace 栏输入_,即可一键清洗研发无法识别的非法空格; - 自动递增序号:输入
Banner_后点击 Number ↑(对应$nn),从01开始自动编号,告别Banner copy copy。
- 用
_与.前缀隐藏内部结构组件:- 在发布 团队组件库(Team Library) 前,将所有仅用于内部拼装的辅助模块(如
.Base_FocusRing、_Table_Cell_Spacer)加上英文句点.或下划线_前缀; - 发布库弹窗会自动把它们归入 Private to this file(仅限本文件私有),保证业务侧搜索组件时干净纯粹,不被底层零件干扰。
- 在发布 团队组件库(Team Library) 前,将所有仅用于内部拼装的辅助模块(如
四、实操三:对齐组件属性与 Variables 的语义化代码映射 #
命名规范的终点不是“在 Figma 里看着整洁”,而是让前端、iOS 和 Android 工程师能够零歧义地直接消费。
- 组件属性(Component Properties)严格对标前端 Props:
- Boolean(布尔开关):统一采用
hasIcon、isDisabled、showBadge等“动词+名词”驼峰命名,切忌用中文“是否显示图标”或模糊词“开关 1”; - Text(文本属性):命名为
label、placeholder、helperText,方便前端工程师直接对应组件代码里的 Props 字段; - Variant(枚举变体):属性名与值尽量使用前端代码同款单词(如
size: sm | md | lg、variant: primary | secondary | ghost),并开启组件属性面板的规范排序(核心维度置顶)。
- Boolean(布尔开关):统一采用
- 为 Variables 配置多端 Code Syntax:
- 在 Figma Variables 面板中,设计侧为了方便阅读可以使用
/分组(例如color/text/primary); - 右键编辑变量进入 Code syntax 标签,分别录入跨平台代码名称:Web 端填
var(--color-text-primary),iOS 填Color.textPrimary,Android 填AppColors.textPrimary。这样设计师保留人性化的目录分组,研发在 Dev Mode 直接复制即可上生产环境。
- 在 Figma Variables 面板中,设计侧为了方便阅读可以使用
五、命名规范落地常见翻车与排查表 #
在大型团队推行命名规范时,以下四类问题出现频率最高,可按对照表快速定位修复(更多全局故障见 Figma 常见报错与疑难故障诊断手册):
| 常见翻车表现 | 底层原因定位 | 标准化排查与修复方案 |
|---|---|---|
| 切图交付给 Android 研发后编译报错失败 | 切图文件名包含大写字母、中划线 -、中文汉字或以数字开头 | Android 资源目录强制要求全小写字母、数字与下划线;用 ⌘/Ctrl + R 批量转为 ic_tab_home_24 格式 |
| 按钮或卡片切换 Variant 后,原本修改的文本变回默认字 | 不同变体内部的文本图层命名不同(如默认态叫 Title,禁用态叫 Text) | 选中整个 Component Set,使用 Multi-edit 同步将所有态的文本层统一命名为 Label |
| 发布团队库时不小心把十几个底层辅助块也推给了全员 | 构建组合组件时,拆分出的内部垫片或子容器未加隐藏前缀 | 在组件名前统一加上 . 或 _ 前缀(如 .Atom_Slot),重新 Publish 即可从全员资产面板撤回 |
| Dev Mode 生成的 CSS 类名或代码片段满屏乱码或无意义后缀 | 画布中存在大量未命名的 Frame 1245 或直接使用了特殊 Emoji 符号作为容器名 | 业务交付区画板与核心外层容器全部改为英文语义或中英文规范名,Emoji 仅限用于 Page 页签分类前缀 |
核心手册与速查工具
高频手册与实用设计生产力工具直达常见问题与答疑 (FAQ)
高频疑难解析与避坑指南完全不需要。绝大多数核心功能在免费 Starter 计划中均可完整体验与实操练习,无需额外付费购买付费团队版。