tanstack-query-v5
TanStack Query v5(React Query)是一个用于异步操作、数据获取、缓存与状态管理的技能。它适用于处理服务端数据获取、异步操作、变更(mutations)、无限查询和乐观更新等场景。该技能要求使用 TanStack Query v5+、React 18+(支持 hooks)以及 TypeScript v5+,并在应用根部配置 QueryClientProvider。核心原则是:任何能从缓存或状态管理中受益的异步操作都应使用 TanStack Query;优先使用手写的查询键元组,与 hooks 同置或放在共享的 queries/ 模块中;绝不手动管理 isLoading、error 或 isError 状态,这些由 hooks 提供。queryFn 可以是任何返回 Promise 的函数,不限于 HTTP 调用。所有 TanStack 特性(缓存、去重、后台重新获取、stale-while-revalidate)对任何数据源都同样有效。