TanStack 知识关系图 — TanStack 中文文档

按产品聚焦

获取机器图谱

课程 05让 Loader 预热 Query 缓存Router 决定何时导航，Query 决定数据如何缓存；用同一份 queryOptions 把两者接起来。

05

Loader / Query

导航与异步缓存

Router 协调何时导航，Query 拥有数据缓存与重新获取生命周期。

工程资料 / decisionRouter Loader 还是 Query？根据导航关键性和数据生命周期选择 Loader、Query 或两者组合。工程资料 / recipe在路由 Loader 中预取 Query为 SSR 创建请求级 QueryClient，并让 Loader 与 useSuspenseQuery 使用相同 queryOptions。

课程 06从 Server Function 写回缓存验证网络边界上的输入，通过 Mutation 表达写入状态，再用服务端响应不可变地更新 Query 缓存。

06

Mutation / 失效

写入与缓存一致性

验证写入边界，并根据服务端响应选择直接更新或失效缓存。

工程资料 / recipe用 Mutation 响应更新缓存当写入响应包含完整实体时用 setQueryData；无法推导正确缓存时改用 invalidateQueries。

课程 10先定义数据何时算新鲜分清 staleTime 与 gcTime，用共享 queryOptions 把查询键、请求函数和时间策略放在一起。

10

staleTime / gcTime

缓存新鲜度策略

分别定义数据何时陈旧，以及 inactive 查询应在缓存中保留多久。

工程资料 / contract定义 Query 新鲜度契约根据数据变化频率设置 staleTime，并独立决定 inactive 缓存的 gcTime。

课程 13让 Query 取消真正传到网络层消费 queryFn 提供的 AbortSignal，让失效的 fetch 停止并理解取消后的缓存状态。

13

AbortSignal / fetch

异步请求取消

把 Query 的 AbortSignal 传到网络层，停止过期 I/O 并保持缓存状态一致。

工程资料 / contract消费 Query 的 AbortSignal将 queryFn signal 传入底层请求，使取消停止 I/O，并保留明确的缓存回滚语义。

课程 15让无限列表保持有界和可恢复用 initialPageParam、游标和 maxPages 建立明确的翻页契约，同时保持 pages 与 pageParams 的结构一致。

15

pageParam / maxPages

有界无限分页

让服务端游标驱动页面参数，并保持 pages、pageParams 与内存边界一致。

工程资料 / recipe建立有界的游标 Infinite Query用一份 queryKey 管理整个列表，让服务端游标驱动 pageParam，并用 maxPages 控制缓存与重取成本。

课程 16在请求之间隔离并流式恢复 Query用 Router SSR Query 集成自动完成脱水、恢复和流式传输，并为每个服务端请求创建独立缓存。

16

SSR / hydration

Query SSR 与流式恢复

按服务端请求隔离 QueryClient，并为关键数据选择阻塞、恢复或流式传输。

工程资料 / contract配置 Query SSR 与流式恢复为每个 SSR 请求创建 QueryClient，通过官方 Router 集成脱水与恢复，并明确阻塞和流式查询。

课程 17让乐观更新可以安全回滚先选择 UI 级临时结果或缓存级更新，再用取消、快照、回滚和重新验证处理失败与并发。

17

onMutate / rollback

乐观一致性与回滚

用取消、快照、不可变写入和重新验证，让即时反馈最终回到服务端事实。

工程资料 / recipe实现可回滚的乐观更新取消冲突重取、保存缓存快照、不可变写入草稿，并在失败时回滚、完成时重新验证。