用途:在代码开发中实现基于 TanStack React Query v5 的服务端状态管理时调用,提供可复用的查询与变更模式。
主要能力:QueryClient 与 QueryClientProvider 配置(staleTime、gcTime、retry、refetchOnWindowFocus);useQuery 基础查询与选项(enabled、refetchInterval 等);查询键的分层组织与 queryKeys 工厂;useMutation 及 onSuccess 失效、乐观更新(onMutate/onError/onSettled 回滚);useInfiniteQuery 分页加载;悬停与页面预取;依赖查询与并行查询(useQueries);重试逻辑与错误边界;性能优化与 Devtools 监控建议。
使用方式:在客户端组件中通过 Providers 包裹应用并创建 QueryClient;用 useQuery 传入 queryKey 与 queryFn 获取数据;用 useMutation 修改数据并在成功后 invalidateQueries 或 setQueryData;分页用 useInfiniteQuery 配合 initialPageParam 与 getNextPageParam;预取用 queryClient.prefetchQuery。
适用场景:React 应用中的服务端数据获取、缓存、变更与分页列表。
限制:资料未提供具体安装命令、版本兼容细节、收费与平台信息;示例为模式参考,需按项目实际调整。