SuperAPI AI 工具集

tanstack-query-overview-and-setup

通用与其它

查看项目

更新于 10-16 08:36

技能介绍

用途:该技能面向 TanStack Query 本身的入门与配置工作,包括文档结构导航、包与适配器选择、QueryClient 与 QueryClientProvider 的基础搭建、稳定版本检查与适配器版本偏差识别,以及 React Query 命名与迁移的高层说明。

主要能力:帮助判断应安装哪个包、需要哪个框架适配器、如何初始化 QueryClient,并给出官方文档与发布页入口。资料列出的规范参考包括 React 框架文档、安装、快速开始、DevTools 页面以及 GitHub releases。

使用方式:按路由线索分派任务。询问“什么是 TanStack Query”“React Query”“装哪个包”“需要哪个适配器”“如何设置 QueryClient”“文档在哪”时使用本技能;涉及 useQuery、useQueries、useInfiniteQuery、query key、缓存默认值、失效、重试或取消时转到 tanstack-query-fetching-and-cache;涉及 useMutation、乐观更新、离线变更、持久化、广播同步或 devtools 时转到 tanstack-query-mutations-and-sync;涉及 SSR、hydration、dehydrate、HydrationBoundary、Next.js App Router、流式渲染或路由预取时转到 tanstack-query-integration-and-rendering;涉及 queryOptions、skipToken、key 注册、测试或 @tanstack/eslint-plugin-query 时转到 tanstack-query-typescript-and-tooling。

操作规则:需显式选择框架适配器,@tanstack/query-core 是共享逻辑,应用代码通常需要 @tanstack/react-query 或 @tanstack/vue-query 等适配器;QueryClient 生命周期属于配置正确性,应在每个应用运行时边界创建一个稳定客户端;适配器选择留在本技能,但真正功能开发前应路由到对应技能;默认以 React 文档为中心,同时兼顾 Vue、Solid、Svelte、Preact、Angular。

限制与快照:资料基于 2026-03-24 官方文档核对,稳定文档线为 TanStack Query v5,核心 npm 线为 5.95.2;官方文档支持的适配器有 React、Preact、Vue、Solid、Svelte 和实验性 Angular。具体安装命令、完整 API 细节与收费信息暂未提供。