UI 视觉设计 / 系统课时
发布团队库并检查引用升级
发布团队库并检查引用升级
共享设计库发布后,修改不会自动安全落到所有设计稿中。这里用一次按钮圆角升级演练,先整理命名和弃用信息,再在 Figma 中发布库更新,最后用独立消费文件审阅差异,确认组件实例与变量引用没有被意外破坏。
学习目标
- 按组件命名、弃用标记和引用风险整理待发布内容。
- 从 Figma 源文件发布团队库,并留下可供消费方判断的变更说明。
- 在消费文件中逐项审阅更新,检查实例覆盖、主题颜色和布局回归。
发布前冻结变更范围
以下操作针对支持团队库发布的 Figma 付费计划;发布者需要源文件的编辑权限及 Full 席位。首次发布前,先把源文件从 Drafts 移入团队文件夹,并确保文件至少包含一个组件、样式或变量。
以 DS Core 库的一次改版为例,先写好变更台账:
| 资产 | 本次变更 | 消费文件需要检查的内容 |
|---|---|---|
Button 组件集 |
Hierarchy=Primary 的圆角从 8 px 调到 10 px |
按钮高度、文本居中与自定义宽度 |
Button/Legacy |
名称和描述标为 [Deprecated],指向 Button |
老实例仍能用,新页面不再选旧组件 |
color/action/primary |
保持变量名称及别名关系不变 | Light、Dark 模式下填充颜色正确 |
组件集的变体属性名称应统一,例如都用 Hierarchy、State、Size,不要在同一库里混用 Type、Status 表示同一维度。要弃用旧资产时,先在名称和组件描述中注明替代项及迁移期限;不要直接删除主组件或复制重建来代替原主组件,以免失去既有实例的链接关系。
从源文件发布共享库
- 打开
DS Core源文件,检查主组件、变量以及要发布的内容。 - 在左侧进入
Assets,点击Libraries;在This file区域找到当前文件并点击Publish。 - 审核待发布的组件、样式和变量。若使用 Organization 或 Enterprise 计划,按实际协作范围选择团队、组织或可用工作区,避免扩大可见范围。
- 填写有影响范围的说明,例如:“v1.3:Primary 按钮圆角 8→10 px;Legacy 标记弃用,替代项为 Button;请重点检查登录页和设置页。”然后点击
Publish。 - 返回库面板确认该批修改不再显示为待发布变更,并在文件版本历史中核对发布记录。
发布是源文件向消费方提供新版本,不等于强制替换所有设计稿里的实例。尤其是组件属性、变量别名、尺寸约束一起改动时,应让消费方先看差异,再决定何时接收。
在消费文件逐项审阅升级
- 新建一个独立的测试设计文件,在
Assets→Libraries中找到DS Core,选择Add to file。将Button实例放在测试画板,分别准备默认态、禁用态、修改按钮文案和自定义宽度四个样本。 - 在源文件发布更改后,回到测试文件。左侧导航底部的
Libraries图标出现蓝色标记时,点击Review library updates,进入Updates标签;打开Show updates for all pages,避免只检查当前页面。 - 选中
Button的更新并进入Review update。先用Side by side对照旧版和新版,再切换Overlay检查圆角与位置;确认无误后对单个实例使用Update instance,而不是立即批量Update all。 - 检查四个样本的文字覆盖、禁用状态、图标间距、Auto layout 和响应式宽度;如果库还修改了变量,切换 Light、Dark 模式核对按钮填充及文字对比度。全部通过后再对其余实例接收更新。

判断异常并决定是否放行
| 测试现象 | 优先检查 | 修正动作 |
|---|---|---|
| 消费文件看不到更新 | 源文件是否完成 Publish、消费文件是否启用该库、是否引用了变化的资产 |
重新核对发布内容及库连接,刷新文件后再查 Updates |
| 文字未随主组件变化 | 实例上的文本覆盖可能仍在生效 | 在该实例检查覆盖值;需要统一时再重置相应覆盖 |
| 深色模式颜色不对 | 语义变量的 Dark 模式映射或实例是否用了直接填色 | 修复别名或填充引用,重新发布并逐项验证 |
| 旧组件无法从资产面板新增 | 是否设为 Hide when publishing 或被删除 |
未完成迁移则恢复发布,明确替代组件与迁移日期 |
验收门槛可定为:四个测试实例全部检查通过,Light 与 Dark 两种模式均无颜色错误,登录页和设置页两处真实使用场景无布局溢出,且未完成迁移的旧组件仍可追溯。任一项失败,暂停批量更新,先修复源组件或消费文件中的覆盖配置。
按自己的节奏,确认真正理解。