Figma 组件实例怎么替换主组件属性：Variants、Instance swap 与发布前验收

在 Figma 里，组件实例的属性替换、主组件切换不是零散的操作：按钮的尺寸、颜色和交互状态适合用 Variants，按钮里嵌套的图标或头像则更适合用 Instance swap。配置完成后，使用者可以直接在右侧面板完成替换，原有文本覆盖值也方便在验收阶段核对。

如果只是让同一组件切换自身状态，用 Variants；如果要替换组件内部的另一个嵌套实例，用 Instance swap。替换完成后，要同时检查右侧属性值、画布显示效果和原有覆盖值。

先把两类变化分开

Variants 属于组件集下的单个子组件，用来描述 size、color、state 这类可枚举属性。Instance swap 则定义主组件或变体内部某个嵌套实例允许替换为哪些指定组件。组件整体切换形态时建 Variant，只替换内部小部件时建 Instance swap。

在主组件中创建 Instance swap

1. 打开存放主组件或组件集的源文件，选中需要配置的主组件。
2. 在右侧面板找到 Properties，选择 Instance swap。
3. 在属性创建对话框中填写属性名称，设置默认实例；需要限制可选范围时，再添加 preferred instances。
4. 选中主组件或变体内部的目标嵌套实例，在右侧面板绑定刚创建的属性，确认紫色属性标识出现在目标层附近。

属性名建议描述用途，例如 Icon，而不是 Layer 17。默认实例决定首次插入时的外观，preferred instances 只是整理候选，不会删除其他组件。

在实例中替换并保留覆盖值

把主组件拖入业务文件后，选中实例，在右侧面板找到 Instance swap 属性，选择目标组件。如果同时配置了 Variant，再按 Size、Color 或 State 选择目标变体。替换后不要只看画布，点开右侧面板确认属性值确实指向目标。

Figma 会尝试保留实例覆盖，但不同替换路径能保留的内容并不完全一致。官方说明优先尝试保留文本覆盖，因此颜色、间距和嵌套结构要结合画布逐一核对。

验收顺序：
1. 右侧面板：Instance swap 指向目标组件
2. 画布：图标、尺寸、状态与目标变体一致
3. 文本：原有文案覆盖没有被意外重置
4. 结构：没有因为 Detach instance 失去组件关联

发布前用一个小实例回归

如果组件来自共享库，先在源文件完成修改，再用真实业务文件回归。打开 Assets 面板进入 Libraries，查看是否有待发布更新；发布前检查组件名、属性名、默认值和 preferred instances 是否清楚。

发布库需要文件中至少存在一个组件、样式或变量，并且权限和套餐条件满足。点击 Publish 后写一条变更说明，再回到使用文件查看更新提示，实际更新一个实例并重复上面的四项检查。

替换结果不对时怎么修

如果右侧没有 Instance swap，先确认选中的是组件内部实例而不是普通图层；如果候选不对，回到主组件检查默认实例和 preferred instances；如果文字恢复默认值，检查目标组件是否拥有对应的文本属性。

如果组件已经被 Detach，撤销这一步通常比重建关联更稳妥。必须重建时，先复制一个未拆离实例作为对照，分别核对属性、文本和视觉状态，再把结果写入发布说明。

最后留一条可复用的验收记录

在发布说明或团队变更记录中保留四项结果：默认实例、允许替换的实例范围、目标变体清单、真实使用文件是否完成更新回归。以后调整按钮状态或图标时，就能判断应该改 Variant 还是 Instance swap。

常见问题：组件属性验收

Variants 和 Instance swap 能同时使用吗？可以。前者控制组件集的状态或尺寸，后者控制组件内部某个实例的替换，验收时分别查看对应属性。

为什么替换后文字变回默认值？目标组件可能没有对应的文本属性，或替换路径只能保留文本覆盖。回到主组件检查文本属性，再用真实实例复测。