用途:面向 TanStack Query 的读取侧服务端状态流程,不涉及服务端渲染或写入侧 mutation 编排。
主要能力:查询键(queryKey)设计与查询函数结构;useQuery、useQueries、useInfiniteQuery 及客户端 useSuspenseQuery;依赖查询、并行查询、分页与无限查询选择;staleTime 与 gcTime 等缓存新鲜度默认值;失效、重取过滤、重试与取消。
路由线索:出现 useQuery、useQueries、useInfiniteQuery,或“为什么重新取数”“如何设计查询键”“缓存条目为何消失”等问题时使用本技能;涉及 useMutation、乐观更新、mutation 回调失效、持久化或离线恢复,应转向 tanstack-query-mutations-and-sync;涉及服务端预取、水合、Next.js、流式或 HydrationBoundary,转向 tanstack-query-integration-and-rendering;涉及 queryOptions 类型、skipToken、模块增强、测试或 ESLint 规则,转向 tanstack-query-typescript-and-tooling。
使用方式:先设计 queryKey 再操作缓存 API;区分 staleTime(新鲜度)与 gcTime(保留期);单查询用 useQuery,动态并行集合用 useQueries,仅当数据模型确为分页参数驱动时用 useInfiniteQuery;分页过渡需保留旧 UI 时优先 placeholderData;需要真正取消请求时在 fetcher 内使用 AbortSignal。
限制:一旦出现服务端边界,预取与水合工作不属本技能。资料未提供安装命令、收费与价格信息。维护快照日期 2026-03-24,文档线为 TanStack Query v5;核心缓存默认值经官方文档核实:默认立即过期,非活跃查询 5 分钟后垃圾回收,失败查询默认重试 3 次。