设计师常见错误

先找到对应问题，再修正源设计，重新检查，并确认内容和行为没有被破坏。以下问题并非都能由插件自动发现。

本地报告：两个真实错误、定位图层与重新检查. 本地开发版的真实截图，并非已发布界面。 查看原图.

图解入门说明这些决策为什么对团队重要。

1. 多余的包装层

问题：图层之间套了多层容器，却说不清每层的作用。

修正：每个包装层都应承担实际职责，例如分组、列表或网格布局、裁剪、共享背景、叠层范围、语义区域或交互目标。只保留有职责的层。

2. 断点之间的文本变化

问题：桌面版和移动版使用相同标识，却表达不同内容。

修正：不同宽度保留相同的产品文案。语言、实验或产品版本差异应作为独立变体建模，而不是混入响应式布局。

3. 没有目的地的按钮

问题：按钮已经画好，但点击后做什么仍不明确。

修正：导航使用 [href=...]，已知的非导航动作使用 [action=...]。尚未确定时，使用草稿 [link] 或 [control]，并为待解决问题指定负责人。草稿标记不代表行为已经定义完整。

4. 没有模态框的模态按钮

问题：按钮声明打开模态框，但源设计中没有对应目标。

修正：创建标识匹配的模态目标，或将动作改为正确的已有目标。

5. 各处的高度固定

问题：卡片和文本块只适合预先挑选的内容，换成真实内容就被裁剪。

修正：优先使用 Hug contents 或内容驱动的尺寸。确需固定高度时，说明原因及溢出处理方式。

6. 自由定位元素而不是结构

问题：相关图层仅在视觉上靠近，缺少可随宽度变化的结构关系。

修正：页面根、可编辑区块根，以及含至少两个可见且有意义的流内子项的普通容器应使用原生 Auto Layout。真正作为完整视觉资源交付的 [asset] 区块可保持内部构图。将资源边界外的 Figma GROUP 替换为 Auto Layout 框架或组件。[decor] 只标记具体的绝对定位装饰层；复杂且整体交付的装饰视觉使用 [decor] [asset]。

7. 用图像代替可编辑文本

问题：文本被导出为图片，无法翻译、索引、编辑或适应布局。

修正：保留原生文本。只有视觉效果确实要求整体交付时，才将其作为资源并说明原因。

8. 命名不稳定

问题：同一逻辑元素在不同宽度下使用不同名称或标识。

修正：保持一个稳定的英文 kebab-case 图层名；只有 Figma 原生信息无法表达意图时，才补充所需的 DFC Bridge 标签。

9. 隐藏层作为真相来源

问题：当前状态、旧文案和未确定版本都藏在隐藏图层中。

修正：将真实状态明确建模为视图、状态、组件变体或目标。将旧版本移出交付范围。

10. 手动换行而不是适当的文本区域

问题：标题和正文依赖设计师手动插入的换行才能排好。CMS 或本地化内容没有这些换行时，布局就失效。

修正：让文本按容器宽度自然换行，使用 Hug contents、最小高度、最大宽度及明确的溢出或截断规则。只有语义或已批准的品牌组合要求固定换行时，才使用 [bridge-exception=manual-line-break] [reason=...]。