第三章 项目与文件组织规范:文件夹结构、命名规则、归档标准

适用场景

本规范适用于所有需要多人同时操作的 Figma 设计项目,尤其在团队成员超过 3 人、项目周期超过 2 周、或涉及多个交付版本的设计系统中。当出现以下情况时必须立即执行本规范:

  • 多人同时编辑同一文件导致覆盖或冲突
  • 无法快速找到某个页面或组件的最新版本
  • 设计师之间使用不同的文件命名习惯导致沟通混乱
  • 项目结束后需要归档给开发或下游团队

前置条件

  1. 所有团队成员已完成 Figma 账户注册并加入团队团队空间(Team)。
  2. 拥有至少一个团队项目(Project)的编辑权限。
  3. 团队已统一约定使用 18px/16px 网格和 Auto Layout 基础规范。
  4. 准备好 Figma 的“文件-版本历史”功能(专业版/企业版自带)。

操作步骤

步骤 1:建立统一的项目文件夹结构(根级)

在 Figma 项目(Project)内,按照以下固定层级创建文件夹(Folder):

  • 📁 01-设计稿 —— 存放所有正式页面的主文件
  • 📁 02-组件库 —— 存放团队共享的设计系统、原子组件、图标
  • 📁 03-设计探索 —— 存放原型、实验稿、待定方案
  • 📁 04-交付与归档 —— 存放最终评审通过的版本、切图、标注
关键点: 文件夹编号(01-、02-)保证排序稳定,不要使用字母排序,避免因名称长度不同导致顺序混乱。

步骤 2:执行文件级命名规则(文件内页面)

每个文件内页面(Page)按照“模块_版本_状态”格式命名:

字段 规则 示例
模块 中文或英文缩写,使用 PascalCase Onboarding、Profile、Cart
版本 v{主版本}.{次版本}.{修订号},两位数字 v1.2.3
状态 WIP (进行中)、Review (待评审)、Done (已完成)、Archive (已归档) Onboarding_v1.0.0_Done
💡 提示: 文件名中不要包含个人名称(如“xx的副本”),避免离职后文件归属混乱;使用版本号代替日期(如 v1.2.3 而非 20250320),方便 diff 和版本历史追溯。

步骤 3:归档标准(每个迭代结束)

  • 将所有已完成(Done)页面移动至 04-交付与归档 文件夹。
  • 归档文件必须锁定(Lock)所有图层,并删除无用 Frame 和组件。
  • 在文件说明(Description)中填写:最后修改时间 | 设计师 | 开发对照链接。
  • 团队共享组件库必须每周发布一次新版本,并将旧版本标为 Deprecated。

输入输出物

类型 输入物 输出物
文件夹 原始杂乱文件 规范化的 4 级文件夹结构
文件 未命名/重复文件 遵守命名规则的页面
版本 WIP 草稿 带版本号的 Done 文件

责任边界

  • 项目负责人(PM): 监督文件夹结构一致性,定期检查命名是否符合规则,每周公布一次“整洁度评分”。
  • 资深设计师(Lead Designer): 维护组件库文件夹,审批归档版本。
  • 每位设计师: 对自己创建的文件和页面命名负责,在启动新页面时立即应用命名规则,不得拖延。

记录材料

  • 团队内建 Wiki 页(Notion / Confluence / Figma 项目说明):记录本规范原文及实时的文件夹结构截图。
  • 每周自动化检查脚本(可选):通过 Figma API 扫描文件命名并打标签(超标项标红)。
  • 归档清单表格:每次迭代结束由 PM 更新,包含文件名称、版本号、归档时间、负责设计师。

异常处理

  1. 冲突命名: 发现两个文件使用相同名称时,立即在“协作频道”发起投票确定标准名;临时锁定较旧文件,加上 _DUPLICATE 后缀。
  2. 误删文件: 利用 Figma 的版本历史恢复(最多 30 天),恢复后通知 PM 重新标记状态。
  3. 跨文件夹移动: 从 03-设计探索 移交至 01-设计稿 时,必须评审通过并补充版本号,否则拒绝移动。
  4. 组件库版本混乱: 发现多人同时编辑同一个库文件时,立即将库文件设为只读,安排唯一维护者解决问题。

验收标准

  • 所有设计文件均位于正确的 4 级文件夹下。
  • 页面名称均符合 模块_版本_状态 格式,无缺字段、无拼写错误。
  • 每个归档文件都包含完整的 Description 字段(最后修改时间 / 设计师 / 开发链接)。
  • 组件库文件夹下无 Deprecated 之外的历史版本。
  • 连续两周不出现命名冲突记录。
文件夹结构与命名流程框架 项目 (Project) 01-设计稿 02-组件库 03-设计探索 04-交付与归档 文件命名:模块_版本_状态 示例:Onboarding_v1.0.0_Done 归档标准(迭代结束) 1. 移动至 04-交付与归档 锁定图层 + 删除无用内容 2. 填写 Description 字段 时间 / 设计师 / 开发链接 3. 组件库标记 Deprecated 每周发布新版本 ⚠️ 异常处理:冲突 → 锁定 + 加 _DUPLICATE 后缀;误删 → 版本历史恢复;组件混乱 → 设为只读修复
⚠️ 常见陷阱: “01-设计稿”文件夹内不要直接存放未命名的文件副本,否则会导致其他设计师找不到主文件;建议要求所有新增文件必须在创建后 30 分钟内完成命名和归位,否则系统自动标黄提醒。

关键检查清单(每日协作前确认)

  • ☐ 当前工作是否在对应文件夹内?(非随意新建根级文件)
  • ☐ 最新修改的文件版本号是否已更新?(避免多人同时编辑同一版本)
  • ☐ 归档文件是否已锁定并填写 Description?
  • ☐ 组件库是否已同步给团队最新发布?