writing-for-interfaces

界面文案写作

优秀的界面文案浑然天成。当文字与设计无缝配合时，人们甚至不会注意到它们。

写作应从一开始就融入设计流程，而不是留到最后才补上。将文字与布局、交互和视觉设计一并考虑，最终效果才会浑然一体。如果把文字当作事后补充，产品体验就会显得拼拼凑凑。

界面中的每段文字，都是一次小小的沟通：它应尊重用户的时间，设身处地为用户着想，并帮助他们继续前进。

---

触发时

步骤 1：确立语气与个性

语气是基础。所有文案决策——说什么、怎么说、略去什么——都取决于是否清楚了解产品是什么、面向谁，以及应该呈现怎样的声音。没有明确的语气，文案就会前后不一，产品也会失去连贯性。

查找现有的语气定义。 检查以下内容：

• 定义语气和／或风格的 CLAUDE.md、AGENTS.md 或类似项目配置
• 风格指南、设计系统文档或品牌规范
• 词汇表或术语参考

如果存在语气定义， 则以此为准开展所有文案工作。如果你正在处理的文案偏离了既定语气，请指出这种不一致。

如果不存在语气定义， 则从现有文案中推断当前语气。寻找其中的规律：正式还是随意？专业还是通俗？亲切还是客观？如果文案前后不一，或信息不足以推断，请先帮助用户确立语气，再开始写作。

通过对话确立语气

引导用户回答以下问题：

1. 产品的功能是什么？面向哪些用户？ 面向专业人士的银行应用和面向儿童的储蓄应用用途相似，但表达方式应截然不同。目标受众决定了词汇、复杂程度和语体。

2. 人们为什么使用产品？在什么场景下使用？ 在危急情况下使用健康应用的人需要冷静、清晰的表达。在家浏览游戏的人则能接受活泼的语气。使用场景——所处的物理环境、情绪状态、注意力分散情况——会影响人们能理解多少文字，以及什么语气才合适。

3. 想象产品是一个人。哪 3–4 个个性特征能让它与众不同？ 先自由集思广益，将相近的词归为主题，舍弃理所当然的特征（“不让人困惑”），保留真正能体现产品个性的特征。

4. 寻找有效的张力。 最好的语气定义包含彼此牵制的特质。“亲切”和“简洁”之间就存在一种有益的张力——调整不同场景下的语气时，可以把这些特质当作调节旋钮。

5. 记录下来。 建议用户将语气定义保存在易于长期查阅的位置（AGENTS.md、CLAUDE.md 或风格指南文档），以便在不同会话中保持一致。词汇表与语气定义相辅相成，应保存在同一个文件中。

步骤 2：评估需求

确定需要开展哪种文案工作：

• 新文案：从头为屏幕、流程或组件撰写文案。
• 审核：评估现有文案的清晰度、一致性和语气。
• 改写：改进效果不佳的具体文本。
• 术语：创建或维护词汇表。

然后确定涉及哪些界面模式， 并查阅 references/patterns.md 中的相关章节。

第 3 步：应用语气，然后应用原则

处理每段文案时，都按以下顺序进行：

1. 听起来符合品牌语气吗？ 对照 3–4 项特质阅读文案。大声读出来时，你能认出这是这个产品写的吗？
2. 在当前情境中，哪些特质需要加强或减弱？ 把每项语气特质都想成一个调节旋钮。庆祝时加强亲切感；出错时加强清晰度，减弱亲和力。
3. 应用核心原则（目的、预判、语境、共情——详见下文）。
4. 应用文案规则（删除填充内容、避免重复、具体表达——详见下文）。

这个顺序是有意安排的，体现了优先级链：清晰度 > 品牌语气 > 文案规则。 清晰度始终优先——如果品牌语气妨碍用户理解该做什么，就应收敛表达。其次是品牌语气——它决定文案听起来如何；文案规则绝不能为了删词或重组短语而削弱既定语气。文案规则是经过品牌语气筛选的启发式原则，而非绝对规则。最终确定前，务必对照品牌语气检查文案修改。

第 4 步：交付修改

逐项处理文案元素——标题、正文、按钮、标签——先展示原文，再展示改写后的文案，并简要说明修改理由，以及它如何符合品牌语气和原则。优先解决会让用户困惑或无法继续操作的问题，再做润色。审查整个流程时，标出术语不一致之处，并在最后建议应加入术语表的词条。

---

品牌语气与语调

品牌语气与语调的区别

品牌语气是产品始终如一的个性，由定义其表达方式的 3–4 项特质构成。这些特质不会改变。

语调是品牌语气根据情境做出的调整。把每项语气特质都想成一个调节旋钮，可根据当下情境调高或调低：

• 庆祝里程碑？加强亲切感，稍微降低简洁度。
• 报告错误？加强清晰度和帮助性，减弱亲和力。
• 引导新用户？平衡帮助性与亲切感。
• 确认破坏性操作？加强直接性，保持冷静、简洁。

实际应用语调

针对每种情境，判断需要突出哪些品牌语气特质，哪些应有所收敛。

示例：如果用户因无法连接网络而遇到错误，就要大幅加强清晰度和帮助性。简洁度保持适中，因为此时用户需要了解最重要的细节。适当减弱亲和力，因为帮助用户解决问题比显得亲切更重要。

个性适合出现的场合

在有空间体现个性的时刻，个性最能发挥作用——例如欢迎页面、里程碑和空状态。在错误消息、破坏性操作和关键流程中，应收敛品牌语气，让清晰度占主导。第 3 步中的优先级链始终适用：清晰度永远第一。

---

核心原则

目的、预判、语境、共情——这是一个指导写什么、怎么写以及何时写的框架。应用时要结合品牌语气。

1. 目的

开始写作前，先回答：此刻用户最需要了解的一件事是什么？

• 运用信息层级。 标题和按钮传达主要信息；辅助文案补充细节。即使用户只读标题和按钮，也应该能明白当前情况。
• 删去与当前情境无关的内容。 将其移至其他位置，或直接删除。如果一个屏幕试图承载太多内容，就回到它的目的上，删去其他所有内容。
• 告诉用户目的。 介绍功能时，说明它为何存在，以及为何与用户相关。

2. 预判需求

把界面想象成一场对话。好的对话总是自然地一来一往：倾听、回应，并预判对方接下来需要听到什么。

• 告诉对方遇到的问题后，也要告诉他们如何解决。“无法连接到 Wi-Fi” → “无法连接到 Wi-Fi。请检查连接后重试。”
• 请对方做某件事后，要明确告诉他们如何操作。“验证你的身份” → “验证你的身份”，并提供清晰的按钮或链接来启动流程。
• 对方完成某件事后，要予以确认并指明下一步。“密码已更改” → “密码已更改。现在可以使用新密码登录。”
• 先说明“为什么”。 把好处或原因放在指示前面：“为了 [好处]，[指示]。”先说明动机，会让指示听起来像合理的请求，而不是命令。

3. 情境

人们使用产品时所处的情境千差万别。使用情境会影响文案的写法。

• 考虑应用之外的情境。 关注人们所处的物理环境和情绪状态。
• 根据可投入的注意力调整信息密度。 任务进行中的文字应极其简短。设置流程则可以写得更详细。
• 把握时机。 在信息相关时展示，而不是过早展示。把说明放在人们正在关注的位置。
• 根据设备来写。 准确描述手势（触屏设备上用“轻点”，而不是“点击”）。手机上的文案要简短；共享屏幕（电视）上的文字则需要更大、更易浏览。

4. 共情

为所有可能使用该产品的人写作，考虑不同的能力、语言、文化、技术熟悉程度和情绪状态。

• 使用通俗、直接的语言。 避免术语、习语和特定文化背景的典故。
• 从一开始就考虑无障碍需求。 标签、描述和替代文本不是事后补充，对某些人来说，它们就是完整的使用体验。有关详细指导，请参阅模式参考。
• 使用包容、中性的语言。 避免不必要地提及性别、年龄或能力。
• 考虑本地化。 写简短的文案，而不是压缩冗长的文案。为文本扩展和 RTL 语言留出余地。

---

写作技巧

通过实用的编辑方法精简文案。确认语气和风格恰当后再应用。

删除填充词

界面文字没有最低字数要求。每个词都必须有存在的理由。但删词前，先确认它是否在塑造语气。按照一般写作规则看似“多余”的词，可能对语气至关重要：“Nothing here yet”（这里暂时还没有内容）中的“yet”传递了温和、平静的感觉。删掉它会让空状态显得更生硬。**判断方法：**删掉这个词；如果意思和预期语气都没有变化，就删掉它。

• 副词和形容词：“Simply enter your license plate”（只需输入车牌号） → “Enter your license plate.”（输入车牌号。）像“只需”“快速”“轻松”“仅”和“成功地”这样的词，往往是在承诺无法保证的事情。只有确实能让意思更清楚时才保留（例如，“自动喂养宠物”）。
• 感叹词：错误提示中的“Oops!”“Uh oh!”会淡化问题的严重性。删掉它们。
• 客套话：自动消息中的“抱歉”和“请”听起来不够真诚。只有确实能增添温度时才使用。
• 标点符号：
  • 感叹号：少用。只在真正值得庆祝的时刻使用。
  • 短横线和长横线：避免在界面文案中使用。它们会打断浏览节奏。改用单独的行或句子。
  • 省略号：只用于表示正在进行的流程（“正在加载...”），不要用来表示话没说完。

避免重复

把重叠的意思合并为一句清晰的话。屏幕上的每个元素都应提供新信息。标题和正文如果只是换种说法表达相同内容，就合并起来。

“We're running late. Your delivery driver won't make it on time. They'll be there in 10 minutes.”（我们晚了。配送员无法准时送达。他们会在 10 分钟后到。） → “Delivery delayed 10 minutes. Check the app for your driver's location.”（配送延迟 10 分钟。请在应用中查看配送员的位置。）

具体明确，避免含糊

• 指明具体内容：“无法打开‘Quarterly Report.pdf’”，而不是“无法打开此文件”。
• 指明具体操作：“取消订阅”／“保留订阅”，而不是“是”／“否”。
• 提供真实信息：“尾号为 4242 的银行卡被拒绝”，而不是“付款出错”。

维护词汇表

决定如何称呼事物，并始终保持一致。如果某个界面上用的是“别名”，另一个界面就不要用“用户名”。词汇表可以是一张简单的表格，包含：使用／避免使用／定义。按钮标签尤其适合列入词汇表——如果“下一步”用于推进流程，就在所有地方都使用“下一步”。

人称代词与视角

“收藏夹”和“你的收藏夹”传达的信息相同。避免使用“我们”——它会掩盖实际发生的情况（“我们遇到了一些问题……”→“无法加载内容”）。

注重细节

正确的拼写、语法和标点能建立信任。选择符合语气的大小写规则（标题式大小写 = 正式，句式大小写 = 随意），并始终保持一致。根据可用空间撰写文案——如果文案需要简短，就写成简短的句子，不要压缩冗长的句子。

为动态内容撰写文案

模板字符串（"${count} items selected"）也是界面文案。撰写时要确保所有可能的输出都读起来自然：

• 处理零个、一个和多个。“没有结果”“1 条结果”“24 条结果”——不要只用一个模板生成“找到 0 条结果”。
• **代入真实值朗读。**替换成较短和较长的名称，以及较小和较大的数字。“欢迎回来，Christopher-Montgomery！”可能会导致布局错乱；“3 秒前”和“2 天前”都应该读起来自然。
• **保持模板简单。**如果字符串需要复杂的条件分支才能读起来自然，可能是设计对单个元素的要求太高了。

建立语言模式

为常见场景定义统一模式——流程如何开始（“开始使用”）、如何推进（“下一步”或“继续”——选一个），以及如何结束（“完成”）。始终保持一致。

---

最简单的测试

大声读出你写的内容。如果听起来像是在向朋友解释事情——清晰、自然、没有废话——那就很可能写得不错。如果听起来像机器人、法律文件或论文，就继续修改。

---

模式参考

关于提醒、错误、空状态、新手引导、通知、无障碍标签、破坏性操作、按钮和说明文案的详细指南，请参阅 references/patterns.md。