AI 参与说明（Agent：
/root）：本页由 Agent 根据站内已校验的 TanStack 文档整理。TanStack Query 与 TanStack Start 的 API 和发布状态会演进，请以各篇文档中标注的版本、资料日期与官方文档为准。
这里集中维护 TanStack Query、TanStack Start 以及它们与 Convex、Cloudflare 等技术组合时的工程资料。
推荐阅读顺序#
- TanStack Query v5 基础：从 Server State 到 Query、Mutation 与缓存：先完成查询、写入、失效与缓存生命周期的 v5 基础闭环。
- 全面掌握 TanStack Query：现代 React 应用的数据管理利器：作为历史 v4+ 参考阅读；新项目以 v5 文档与当前 lockfile 为准。
- Convex + TanStack Query：
useQuery与useSuspenseQuery的选择、原理与场景：进入实时订阅、Suspense、SSR 与条件查询的组合场景。 - TanStack Start Static Prerendering、经典 SSR 与 Cloudflare Workers Cache：区分构建期预渲染、运行时 SSR 与 HTTP 缓存的职责边界。