用途:TanStack Query 是 React 的服务器状态管理与数据获取库,用于请求 API 数据、缓存、变更(mutation)与乐观更新。
主要能力:useQuery 负责数据获取,支持 queryKey、queryFn、staleTime、gcTime、refetchInterval、enabled、retry 等选项;useMutation 负责修改数据,支持 onMutate、onError、onSettled、onSuccess 回调与乐观更新回滚;useQueries 支持并行查询;useInfiniteQuery 支持分页加载;useSuspenseQuery 配合 Suspense 使用。还提供查询键工厂、缓存读写与失效、预取、SSR 水合等能力。
使用方式:安装 npm install @tanstack/react-query,在应用外层用 QueryClientProvider 包裹并创建 QueryClient,可配合 ReactQueryDevtools。查询时传入 queryKey 与 queryFn,变更后用 queryClient.invalidateQueries 刷新缓存。
适用场景:React 应用中需要统一管理服务端数据、缓存、请求状态与乐观更新的场景,包括列表、详情、分页、依赖查询、并行查询与 Next.js App Router 的 SSR 预取。
限制:资料未提供收费、价格、平台支持范围与性能数据;示例基于 React,其他框架用法暂未提供。