做产品 PMaker 首页
搜索
跟随系统
颜色主题
空格的键盘
公式:说明当前状况 + 引导措施,两段都要有说明当前状况发生了什么事,用用户听得懂的话,别暴露状态码引导措施他现在能做什么,给出路、给恢复途径只报状况不给出路的提示等于没写按强度选形式必须立刻纠正用弹窗,一般信息用全局提示,可看可不看用气泡形式按强度分三档,不要越级使用

发生了什么,加上他现在能做什么。这个公式套在任何一条提示上都成立。

提示语怎么写

说明当前状况加引导措施,不用感叹号,句尾不加标点。

提示语是产品跟用户说话的地方。写法有固定公式,不需要每次现想。error-guidelines

你会遇到的现象:

  • 错误提示只说「操作失败」,用户不知道接下来该干嘛
  • 同一个意思在三个地方三种说法,语气也不统一
  • AI 生成的文案全是感叹号,像在冲你喊

两段式公式

提示语由两段组成:说明当前状况,加上引导措施。两段都要有。

别写 改成
操作失败! 没能连上服务器,稍后再试一次
格式不正确 手机号是 11 位数字,请检查一下
Error 500 服务暂时不可用,几分钟后会自动恢复
暂无数据 还没有订单,下单后可以在这里查看物流
已删除! 文件已删除,可到回收站恢复

左边那列的共同点是只说了一半——只讲了状况,没给出路。用户读完还是不知道该干什么。而「操作失败」连状况都没讲清楚:什么失败、为什么失败、接下来怎么办,全都没有。

四条原则

  • **正确。**没错别字、没语法错误、不产生歧义,陈述客观事实。这条看起来是废话,但错别字在提示语里出现的概率意外地高。
  • **有指导性。**用户犯了错就告诉他怎么改,出了问题就给恢复的途径。只报告问题不给出路的提示等于没写。
  • **简洁。**用最精简直观的话,避免长句和技术术语,除非你确定用户懂。
  • **一致。**书写语言、语序、标点、图标全站统一。同一个功能在提示里的叫法要跟界面上一致——界面叫「归档」,提示里就别写「已完结」,用户会以为那是另一件事。

标点与图标规范

  • **统一中文标点。**不要中英文标点混用。
  • **避免感叹号。**它会带来过强的情绪,把一次网络波动渲染成事故。
  • **句尾不加标点。**除非是疑问句。「文件已删除」后面不用句号。
  • **句中用逗号断句。**比一长句好读。
  • **强调对象用双引号。**比如「确定删除"项目周报"吗」,避免误解。
  • 等待类用省略号。「加载中…」「正在验证…」。
  • **内容超长用省略号截断。**设计字段时就要考虑极值,超出用「…」代替。

图标沿用行业惯例就行:感叹号表示警告,问号表示帮助,红色表示错误、黄色警告、绿色成功。这一层不需要创新。选提示形式时按强度分三档:必须立刻修正的错误用弹窗,一般信息和成功提示用全局提示,可看可不看的用气泡。越级使用的代价是用户对整档提示脱敏——什么都用弹窗,等于所有弹窗都不再被读。

给 AI 的话

这套规范适合直接沉淀进项目文件,之后所有文案都按它生成。

CLAUDE.md · 文案规范:

## 提示语

公式:说明当前状况 + 引导措施。两段都要有。
  ✗ 操作失败
  ✓ 没能连上服务器,稍后再试一次

原则:正确、有指导性、简洁、全站一致。
功能名称在提示里的叫法必须跟界面上一致。

标点:
- 统一中文标点,不要中英混用
- 不使用感叹号
- 句尾除疑问句外不加标点
- 句中用逗号断句
- 需要强调某个对象时用双引号
- 等待类文案以「…」结尾,例如「加载中…」
- 内容超出显示范围时用「…」截断

强度分档(不要越级):
- 弹窗:必须立刻修正的错误
- 全局提示 / 横幅:状态变化、成功提示
- 气泡 / 红点:可看可不看的信息

错误提示不得暴露状态码、堆栈或英文报错原文,
一律转成用户能读懂的话,并给出下一步操作。

参考资料

  1. Error-Message Guidelines — Nielsen Norman Group