tanstack-query

TanStack Query

关于查询、变更、缓存、乐观更新、SSR、持久化、测试和所有官方适配器的服务端状态指南。

请从与已安装版本匹配的适配器文档开始。Query Intent 草稿指南单独保留，使用前必须对照已安装版本进行核验。

工作流

1. 检查已安装的 TanStack 包及其确切版本。
2. 打开已安装适配器的索引，或从下方的常见任务入手。核对草稿任务指南中的 API 是否与对应版本的适配器一致后，再将其用作补充指南。
3. 主题参考是索引。为任务选择一篇指南或一个章节；仅在需要时，才跟进其前置条件链接。
4. 优先参考已安装包的类型定义和与版本匹配的源代码指南，而不要依赖记忆。
5. 将示例转换为框架适配器时，保留无头／核心行为。

任务路由

• React 适配器 — 与版本匹配的 React 设置、查询和响应性。
• Preact 适配器 — 与版本匹配的 Preact 设置、查询和响应性。
• Vue 适配器 — 与版本匹配的 Vue 设置、查询和响应性。
• Solid 适配器 — 与版本匹配的 Solid 设置、查询和响应性。
• Svelte 适配器 — 与版本匹配的 Svelte 设置、查询和响应性。
• Angular 适配器 — 与版本匹配的 Angular 设置、查询和响应性。
• Lit 适配器 — 与版本匹配的 Lit 设置、查询和响应性。
• 基础知识 — 客户端设置、键、选项、获取、默认值和抽象。
• 变更和缓存更新 — 变更、失效、取消和乐观更新。
• 数据整形 — 分页、无限查询、占位符、选择器和渲染效率。
• 框架和 UI 状态 — 适配器响应性、状态、错误、Suspense 和开发者工具。
• 路由和 SSR — 路由器组合、预取、水合和流式传输。
• 离线和集成 — 持久化、广播、实时功能和表单集成。
• 质量和迁移 — Lint 规则、测试和主版本迁移。

常见任务

• React：乐观更新和回滚
• Vue：响应式输入变化时重新获取

框架路由

• React — 检测 @tanstack/react-query。阅读 React 适配器。
• Preact — 检测 @tanstack/preact-query。阅读 Preact 适配器。
• Vue — 检测 @tanstack/vue-query。阅读 Vue 适配器。
• Solid — 检测 @tanstack/solid-query。阅读 Solid 适配器。
• Svelte — 检测 @tanstack/svelte-query。阅读 Svelte 适配器。
• Angular — 检测 @tanstack/angular-query-experimental。阅读 Angular 适配器。
• Lit — 检测 @tanstack/lit-query。阅读 Lit 适配器。

各适配器指南中列出了适配器版本。尤其要注意，Svelte 和 Lit 使用的主版本可能与 Query Core 不同。草稿任务示例不能证明其他适配器中存在某个 API。

产品边界

如果任务涉及以下产品边界，请使用对应的独立产品技能：tanstack-router、tanstack-start、tanstack-form。

来源状态

来自 TanStack/query 的官方文档，与以下已验证的发布输入相匹配：@tanstack/[email protected]、@tanstack/[email protected]、@tanstack/[email protected]、@tanstack/[email protected]、@tanstack/[email protected]、@tanstack/[email protected]、@tanstack/[email protected]、@tanstack/[email protected]。

有关上游输入和去重记录的准确信息，请参阅来源溯源。