用途:为 Astro 站点提供一套错误处理模式,在出错时保持用户信任并给出明确指引,涵盖自定义错误页、表单校验状态、加载指示、离线兜底与网络错误处理。
主要能力:自定义 404 与 500 页面(含错误追踪);表单的行内字段错误与错误摘要组件;加载状态指示与离线兜底页;列表与搜索的空状态组件;安全 fetch 工具、toast 通知与错误日志。核心规则包括不归咎用户、始终提供下一步、保持品牌一致、提供搜索与常用链接、记录 404 便于修复死链、使用 ARIA 与语义化 HTML 保证可访问性、异步操作给出加载反馈、优雅处理离线、将 HTTP 状态码转成通俗语言、在错误处理器中静默失败以避免错误循环。
使用方式:资料未提供具体安装命令或调用代码,仅说明详细实现见 references/ 目录,包含 error-pages.md、form-errors.md、loading-states.md、empty-states.md、network-handling.md 五个文件;完成标准为具备自定义 404 与 500 页、表单行内错误、异步加载状态、离线兜底页、空状态、操作 toast、生产环境错误日志,且所有错误页与站点品牌一致。
适用场景:需要提升 Astro 站点错误体验与健壮性的前端开发。
限制:不支持的技术栈、版本要求、依赖与安装方式暂未提供;禁止在错误信息中使用技术术语、归咎用户、只写“出错了”而无后续步骤、错误页缺少导航、静默失败、忽略 404 追踪。