实践指南
错误信息与空状态:让 AI 生成的产品更像「成品」
说明如何把错误文案、空列表与加载态写进 Skill 完成定义,减少演示可用、真实难用的半成品界面。
RuleHub 编辑组约 2 分钟阅读
UX空状态错误处理AI 编程
半成品的典型症状
主路径有数据时好看;一旦列表为空、接口 500、搜索无结果,页面就只剩空白或原始英文堆栈。AI 默认优化「有内容的截图」,空与错往往被忘掉。
三类状态都要有主人
加载
骨架屏或明确 loading,避免布局狂跳。
空
说明为什么空、下一步做什么(例如「去搜索 Skills」链到 /search)。
错误
用户可读的说明 + 可重试;细节进日志,不进 UI。对齐 API 安全 的错误暴露原则。
写进完成定义
在 UI Skill 中要求:
- 列表组件必须处理 empty
- fetch 失败必须有错误区
- 禁止把
error.message直接展示给终端用户(生产)
反模式写法见 反模式指南。
文案原则
- 短、具体、可行动
- 不指责用户
- 中文产品用中文错误句,不要混一串未翻译键名
验收
故意断网、清空数据、输入无匹配关键词,三种情况下页面仍「像产品」。无障碍上也要让读屏能读到状态变化,参见 a11y 五条。
小结
空与错是产品完成度的试纸。把它们写进 Skill 的 DoD,AI 交付物会从 Demo 更接近可上线。
下一步:抽查站内列表页(创作者、新闻、洞察)的空数据表现是否友好。