TANSTACK中文文档
搜索文档/官方文档EN
浏览文档目录
Agent 文档

为任务取回最小、正确的上下文。

这里没有写给人类的长篇教程。每篇资料都声明任务、包、版本、约束、最小实现和验证方式。

Agent 入口GET /zh-cn/llms.txt
  1. 01获取 llms.txt
  2. 02按产品选择
  3. 03按 task 取回单篇
  4. 04检查 versionRange
CATALOG / 19

可用知识单元

同时提供 HTML 阅读页与原始 Markdown。

01

TanStack Start

全栈应用框架

recipe创建只在服务端执行的函数使用 createServerFn 定义同源、类型安全的服务端 RPC。^1recipe创建外部可调用的 Server Route为第三方调用方建立原生 HTTP 端点，并显式返回状态、缓存和安全响应。Start ^1 / Router ^1contract建立 Start Middleware 执行链明确请求级与函数级作用域，通过 next() 组合上下文，并保留认证和 CSRF 边界。^1
02

TanStack Router

类型安全的路由与 URL 状态

recipe创建带路径参数的文件路由在 React 应用中创建 /posts/$postId，并从路由实例读取类型安全的 postId。^1recipe验证分页与筛选参数将不可信的 URL 搜索参数转换为稳定、有类型的路由输入。^1error隔离路由 Loader 与渲染错误为全局 Router 设置默认错误组件，并在需要独立恢复的路由上覆盖 errorComponent。^1contract建立类型化 Router Context在根路由声明依赖，并通过 beforeLoad 为子树追加可推导的派生上下文。^1recipe保护脏表单的离页导航用 useBlocker 的 resolver 状态实现可访问的离页确认，并按脏状态注册 beforeunload。^1recipe用 beforeLoad 保护路由子树在 pathless layout 中读取类型化认证 Context，阻止未登录用户加载子路由，并保留经过约束的回跳 URL。^1
03

TanStack Query

服务端状态与异步数据

decisionRouter Loader 还是 Query？根据导航关键性和数据生命周期选择 Loader、Query 或两者组合。Query ^5 / Router ^1recipe在路由 Loader 中预取 Query为 SSR 创建请求级 QueryClient，并让 Loader 与 useSuspenseQuery 使用相同 queryOptions。Query ^5 / Router ^1recipe用 Mutation 响应更新缓存当写入响应包含完整实体时用 setQueryData；无法推导正确缓存时改用 invalidateQueries。^5contract定义 Query 新鲜度契约根据数据变化频率设置 staleTime，并独立决定 inactive 缓存的 gcTime。^5contract消费 Query 的 AbortSignal将 queryFn signal 传入底层请求，使取消停止 I/O，并保留明确的缓存回滚语义。^5recipe建立有界的游标 Infinite Query用一份 queryKey 管理整个列表，让服务端游标驱动 pageParam，并用 maxPages 控制缓存与重取成本。^5contract配置 Query SSR 与流式恢复为每个 SSR 请求创建 QueryClient，通过官方 Router 集成脱水与恢复，并明确阻塞和流式查询。Query ^5 / Router ^1recipe实现可回滚的乐观更新取消冲突重取、保存缓存快照、不可变写入草稿，并在失败时回滚、完成时重新验证。^5
04

TanStack Table

无头表格与数据网格逻辑

contract协调服务端表格的排序与分页状态让 Table 管视图状态、Query 管远程数据，并用 manualSorting、manualPagination 与 rowCount 避免只处理当前页。Table ^8 / Query ^5
05

TanStack Form

类型安全的表单状态与校验

contract为字段异步校验建立安全边界先同步过滤无效输入，再用内置 debounce 执行异步校验，并把提前反馈与最终服务端验证明确分开。^1