Figma 企业级设计系统命名规范全解析:图层结构、斜杠(/)分组、组件属性与 Variables Token 命名约定实战

2026 年 11 月 19 日

在团队协作的早期,很多设计师觉得“只要视觉稿好看,图层叫 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. 控制组件库与样式的折叠层级 #

  1. 建立“分类 / 子类 / 名称”三段式结构:
    • 在 组件与实例指南 中,如果你将两个组件分别命名为 Navigation / TopBar / Default 和 Navigation / TopBar / Search,左侧 Assets 面板以及右侧属性栏的 Swap Instance(替换实例) 下拉框会自动收拢成 Navigation → TopBar 多级菜单,而不是杂乱地堆在一屏里;
    • 层级控制原则:建议最多不超过 3 级斜杠(如 大类 / 组件名 / 细分形态),超过 4 级会导致设计师在弹出菜单里点击路径过深,降低拼图效率。
  2. 区分“组件名分组”与“变体属性(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% 的原因都是变体或画板之间的子图层命名不一致。

  1. 执行“跨变体同构命名”:
    • 同一个 Component Set 下的所有变体,内部核心节点必须保持名称完全一致、嵌套深度一致(深入排查见 组件变体切换覆盖失效治理);
    • 图标组件特例:所有线性或面性图标母版内部的矢量路径层,建议统一命名为 Vector(或 Icon Shape),并合并为单一扁平图层。这样在按钮中替换不同图标时,外部绑定的主色或反白文字变量才能 100% 自动继承而不跳回初始黑色。
  2. 使用 ⌘ + R / Ctrl + R 进行批量正则治理:
    • 选中需要整理的一批图标或图层,按快捷键打开 批量重命名弹窗;
    • 统一加前缀:在 Rename to 栏输入 ic_24_ 后点击下方的 Current name(占位符 $&),瞬间把所有选中图标加上规范前缀;
    • 正则去空格与替换符号:在 Match 栏输入 \s+(匹配一个或多个空格),在 Replace 栏输入 _,即可一键清洗研发无法识别的非法空格;
    • 自动递增序号:输入 Banner_ 后点击 Number ↑(对应 $nn),从 01 开始自动编号,告别 Banner copy copy。
  3. 用 _ 与 . 前缀隐藏内部结构组件:
    • 在发布 团队组件库(Team Library) 前,将所有仅用于内部拼装的辅助模块(如 .Base_FocusRing、_Table_Cell_Spacer)加上英文句点 . 或下划线 _ 前缀;
    • 发布库弹窗会自动把它们归入 Private to this file(仅限本文件私有),保证业务侧搜索组件时干净纯粹,不被底层零件干扰。

四、实操三:对齐组件属性与 Variables 的语义化代码映射 #

命名规范的终点不是“在 Figma 里看着整洁”,而是让前端、iOS 和 Android 工程师能够零歧义地直接消费。

  1. 组件属性(Component Properties)严格对标前端 Props:
    • Boolean(布尔开关):统一采用 hasIcon、isDisabled、showBadge 等“动词+名词”驼峰命名,切忌用中文“是否显示图标”或模糊词“开关 1”;
    • Text(文本属性):命名为 label、placeholder、helperText,方便前端工程师直接对应组件代码里的 Props 字段;
    • Variant(枚举变体):属性名与值尽量使用前端代码同款单词(如 size: sm | md | lg、variant: primary | secondary | ghost),并开启组件属性面板的规范排序(核心维度置顶)。
  2. 为 Variables 配置多端 Code Syntax:
    • 在 Figma Variables 面板中,设计侧为了方便阅读可以使用 / 分组(例如 color/text/primary);
    • 右键编辑变量进入 Code syntax 标签,分别录入跨平台代码名称:Web 端填 var(--color-text-primary),iOS 填 Color.textPrimary,Android 填 AppColors.textPrimary。这样设计师保留人性化的目录分组,研发在 Dev Mode 直接复制即可上生产环境。

五、命名规范落地常见翻车与排查表 #

在大型团队推行命名规范时,以下四类问题出现频率最高,可按对照表快速定位修复(更多全局故障见 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)

高频疑难解析与避坑指南
A

完全不需要。绝大多数核心功能在免费 Starter 计划中均可完整体验与实操练习,无需额外付费购买付费团队版。