用途:为浏览器端单页应用(SPA)提供系统级设计模式参考,包括各类方案的适用与不适用场景、关键决策点、失败模式和反模式。
主要能力与主题: 渲染策略——客户端渲染(CSR)、服务端渲染(SSR)、静态站点生成(SSG)、孤岛架构(Islands),各自说明何时使用、何时避免及关键决策(如 hydration 策略、流式 SSR、增量再生成、框架选择)。 客户端路由——哈希路由、History API 路由、按路由代码分割,涉及服务端 fallback 配置、滚动恢复、路由守卫与分包加载失败处理。 状态管理——本地组件状态、全局状态(Redux、Zustand、Jotai、Signals)、服务端状态(React Query、SWR、Apollo)、URL 状态,说明缓存失效、乐观更新、查询键设计等决策。 认证模式——基于令牌(JWT)、HTTP-only Cookie、OAuth/OIDC 流程(SPA 需用带 PKCE 的授权码流程),涉及存储位置、刷新令牌轮换、CSRF 与 SameSite 等权衡。 性能——包体积(tree shaking、按路由/功能分包、包分析、CI 体积预算)、渲染性能(memoization、虚拟列表、防抖)、网络性能(并行请求、去重、预取、骨架屏)、Core Web Vitals(LCP、INP、CLS)。 离线与 PWA——Service Worker 缓存策略与更新通知、离线数据(IndexedDB、后台同步、冲突解决)。
常见失败模式:过期部署缓存导致分包加载失败、事件监听与订阅内存泄漏、白屏、状态不同步、无限加载、令牌过期丢失未保存内容、SSR hydration 不匹配。
反模式:巨型包、万物皆全局状态、用全局状态规避 prop drilling、直接操作 DOM、客户端安全、在前端代码存放密钥、用 CSR SPA 做内容站、忽视无障碍、缺少加载与错误状态、过早过度抽象。
限制:资料以模式判断与决策要点为主,未提供具体安装命令、代码示例、平台或价格信息,这些内容暂未提供。