状态管理
优先级:P2(中)
实现指南
- URL 状态:将 URL 作为可共享/可持久化状态的单一数据源。URL 参数可在重新加载和链接间共享。通过
useSearchParams()访问,通过useRouter()更新。模式:const params = new URLSearchParams(searchParams); params.set('q', term); useRouter().replace(...)。 - 服务器状态:使用 SWR 或 TanStack Query (React Query) 进行缓存和获取服务器数据。避免手动将服务器数据同步到
useState。 - 客户端状态:使用 Zustand(
create<CartState>()((set) => ({ ... })))——仅用于 'use client' 组件——或使用 Jotai 处理复杂、高频的 UI 状态。通过仅在低频数据场景下使用 Context API,避免 Prop Drilling。 - 状态提升:将状态就近放置(Colocate)在尽可能靠近组件的位置。仅当状态在兄弟组件间共享时才提升到父组件。
- Next.js 15+ 集成:确保 客户端组件 中的状态更新不与服务端渲染逻辑冲突。使用
useOptimistic钩子管理 乐观更新。 - 状态水合:在客户端组件中从
localStorage初始化状态时,务必小心避免 水合错误。应包裹在useEffect中或使用mounted标志。
2. URL 驱动状态(搜索/筛选)
使用 useSearchParams + useRouter 更新 URL 参数。详见 URL 状态模式。
3. 服务器状态(TanStack Query / SWR)
如果您需要在客户端获取“实时”数据(例如轮询股票价格、聊天),请不要手动实现 useEffect 获取。请使用库。
// 自动缓存、去重和重新验证,支持 refreshInterval
const { data, error } = useSWR('/api/user', fetcher, {
refreshInterval: 30000,
});
库模式
有关特定的状态管理模式,请参见:
反模式
- 简单状态不要使用全局存储:使用
useState或 URL 参数;避免对基本 UI 使用 Zustand。 - 状态中不要包含大对象:分解为细粒度基本类型,以防止额外的重新渲染。
- 不要使用
useEffect进行数据获取:使用 SWR 或 TanStack Query 处理服务器状态。 - 不要在客户端存储中包含服务器状态:在 RSC 中获取数据;客户端存储仅用于 UI 状态。