Figma 用一个“注释”，正在悄悄终结设计师和开发的内耗时代

真正拖慢产品节奏的，从来不是技术难度，而是设计和开发之间那点说不清、写不明的“默契”。Figma 在这期 Config 视频里抛出一个反直觉观点：不是更多会议，也不是更详细的 PRD，而是「注释（Annotations）」这种被严重低估的设计细节，正在成为跨职能协作的关键基础设施。

最大的误区：协作的敌人不是“混乱”，而是“隐性假设”

视频一开始，Figma 的 Developer Advocate Akbar 和 Designer Advocate Mal 就点破了一个很多团队不愿承认的事实：设计与开发之间的混乱，永远不可能被彻底消灭。问题不在于“有没有混乱”，而在于哪些混乱是可控的，哪些是纯粹的沟通成本。

真正致命的不是信息多，而是信息“藏在设计师脑子里”。设计师往往默认：“这个按钮点了以后当然会跳转”“这个 loading 状态大家都懂”，而开发拿到文件后，只能根据画面做“最合理的猜测”。Mal 说得很直白：她曾经在代理公司里，把设计稿交出去之后，甚至不知道有没有真正上线。

这对 AI 从业者尤其危险。因为在 AI 产品里，真正决定体验的，往往不是你“画出来”的状态，而是你没画出来的那些：推理中的 loading、失败兜底、边界条件、不同模型返回结果的差异。如果这些只存在于脑补里，那最终一定会在实现时“走样”。

什么才是“好注释”？不是规格表，而是认知补丁

很多人一听到 annotation，脑子里浮现的是密密麻麻的标注地狱：字号、颜色、间距、组件名，恨不得把 Figma 变成 Excel。Akbar 的定义非常克制：注释的本质只是一个“指向设计的便签”。

但真正高价值的注释，有一个共同特征：它们描述的是“屏幕上看不到的东西”。

比如：
- 点击这个卡片，会进入哪个 flow？
- 这个 action 触发后，会不会有一个异步 loading？
- 在超出最大宽度时，这个 logo 是居中还是贴边？

这些信息，对开发来说极其关键，却无法通过 Inspect 面板获得。Akbar 提到一句非常有分量的话：

“我不需要你告诉我按钮多宽，我需要你告诉我，这个按钮背后发生了什么。”

这句话对 AI 产品设计几乎是直击要害。模型行为、异步状态、不可见流程，正是 AI 界面复杂度的来源，而注释恰恰是把这些“隐性认知”外化出来的最低成本方式。

什么时候该写注释？答案不是“越多越好”

Mal 提出了一个所有设计师都会焦虑的问题：我会不会标注太多，反而打扰开发？

Akbar 的回答非常工程化，也非常现实：注释的“密度”，取决于团队的成熟度，而不是工具本身。

如果你的开发非常熟悉 Figma、组件系统和设计 token，那大多数静态属性本身就是噪音；但以下三种情况，几乎永远值得注释：

1️⃣ 行为和状态：尤其是画面里不存在的状态，比如 AI 推理中、失败重试、fallback。
2️⃣ 细微但重要的偏离：比如这个 gap 比设计系统默认值小一点，这往往是最容易被忽略、却最容易引发返工的地方。
3️⃣ “变化本身”：当设计发生修改时，用注释直接点名“这里变了”，比让开发去翻版本对比高效得多。

这其实是一种协作哲学的转变：注释不是为了“讲清楚设计”，而是为了“减少无效同步”。对分布式团队、跨时区协作、AI 研发这种高上下文成本场景，价值尤其明显。

最容易被忽略的杀手级用法：用“相对关系”对齐代码世界

视频里有一个非常容易被忽略，但对工程师极其友好的细节：测量工具 + 自定义注释。

Akbar 演示了一个场景：与其告诉开发“这个元素是 312px”，不如直接注释——“它占屏幕宽度的 50%”。因为在真实代码里，大家用的是相对单位、网格、约束，而不是 Figma 里的绝对像素。

这一步，实际上是在帮设计师和开发“对齐语言”。

对 AI 从业者来说，这一点尤其重要。无论是多端适配、响应式推理结果，还是不同模型返回长度不一的内容，绝对值几乎一定会失效。用注释明确设计意图中的“比例关系”，远比标一个精确数字更接近真实系统。

Mal 在这里点出了一个关键洞察：很多这种信息，设计师不是不愿意写，而是根本不知道开发需要。这正是 annotation 成为“桥梁”的地方。

总结

这期 Figma 视频真正想传达的，并不是“你应该多写注释”，而是一个更深层的协作信号：设计和开发的分工边界，正在从“交付文件”转向“共享理解”。

对 AI 从业者来说，这意味着什么？意味着你不能再指望一个静态界面，完整表达一个动态、概率化的系统行为。你需要用注释，把模型行为、边界条件、变化意图清楚地钉在设计上。

一个值得带走的行动建议是：下一次设计评审时，不要问“这个标注全不全”，而是问一句——“如果我只看这个画面，哪些关键决策我一定会猜错？”那些地方，就是最值得写注释的地方。

真正高效的团队，不是没有混乱，而是不会被误解反复拖慢。

关键词： Figma， Annotations， 设计与开发协作， AI 产品设计， Dev Mode

事实核查备注： 需核查：视频标题与发布时间（2025-01-07）；发言人身份（Akbar 为 Figma Developer Advocate，Mal 为 Designer Advocate）；功能名称 Dev Mode、Annotations、Measurement Tool 是否为 Figma 官方叫法