#架构与核心概念

TanStack Start 可以理解为 TanStack Router 应用的服务端化。

React Components
  ↓
TanStack Router: route tree, params, search, loaders
  ↓
TanStack Start: SSR, streaming, server functions, server routes
  ↓
Build/runtime: Vite or Rsbuild, deployment adapter

#路由树是应用契约

Router 负责路径、搜索参数、loader、导航和 route context；Start 在它周围补充服务端执行环境。这样类型会从路由树自然流向：

• Link 和 navigate
• Route.useParams()
• Route.useSearch()
• Route.useLoaderData()
• Server Function 调用点

#Client-authored, server-powered

Start 鼓励你按客户端应用组织 UI，但在需要时显式进入服务端：

• loader 负责路由级关键数据
• Server Function 负责数据库、密钥、文件系统等服务端逻辑
• Server Route 负责公开 HTTP endpoint
• Middleware 负责请求上下文和认证

#与 TanStack Query

Router loader 适合首屏关键数据；TanStack Query 适合组件级异步状态、后台刷新、mutation cache。常见组合是：Server Function 作为 queryFn / mutationFn，Query 管理客户端缓存。

#运行边界

#下一步

• 文件路由
• 数据加载