TanStack Start 中文文档
快速开始

TanStack Start 总览

注意

TanStack Start 目前处于 Release Candidate(RC) 阶段!这意味着功能已基本完整,API 也趋于稳定。 但这不代表它没有 bug,所以欢迎你亲自试用并反馈! 通往 v1 的道路应该不会太长,所以别犹豫,尽快试试吧!

TanStack Start 是一个建立在 TanStack Router 之上的全栈 React 框架。它提供了整页 SSR(服务端渲染)、流式传输(Streaming)、服务器函数(Server Functions)、客户端/服务端分离构建等能力。基于 Vite 与 Rsbuild,你可以轻松开发并部署到你想要的任何托管平台或运行时。

依赖

TanStack Start 建立在两项关键技术之上:

  • TanStack Router:用于构建 Web 应用的类型安全路由器,支持嵌套路由、搜索参数(Search Params)、数据加载等高级特性
  • Vite 或 Rsbuild:现代构建工具,提供热模块替换(HMR)的快速开发体验和优化的生产构建

该用 TanStack Start 还是只用 TanStack Router?

一个框架好不好,往往九成看它的路由器,TanStack Start 也不例外。TanStack Start 的路由系统 100% 依赖 TanStack Router。 除了 TanStack Router 的出色特性之外,Start 还提供了更强大的能力:

  • 整页 SSR —— 服务端渲染,带来更好的性能与 SEO
  • 流式传输(Streaming) —— 页面渐进式加载,改善用户体验
  • 服务器路由与 API 路由 —— 在前端旁边直接构建后端接口
  • 服务器函数(Server Functions) —— 客户端与服务端之间类型安全的 RPC
  • 中间件(Middleware)与上下文 —— 强大的请求/响应处理与数据注入
  • 全栈构建 —— 同时为客户端与服务端代码优化构建
  • 通用部署 —— 基于 Vite 或 Rsbuild 构建,可部署到任意托管平台与运行时
  • 端到端类型安全 —— 全栈的完整 TypeScript 支持

话说回来,如果你能确定自己完全不需要上述任何能力,那么只使用 TanStack Router 也是一个不错的选择——它依然是比大多数路由器与框架更强大、更类型安全的 SPA 路由方案。

有哪些局限?

TanStack Start 提供了与 Next.js、Remix 等全栈框架相同的能力,且特性更多、开发者体验更强大。React 服务器组件(React Server Components,RSC)作为实验性特性可用——详见 Server Components 指南。

译者注:React 服务器组件是什么?

React 服务器组件(RSC)允许在服务器上渲染组件并把序列化后的结果发送给客户端,而无需下载对应的 JS 代码。它与「服务器函数(Server Functions)」是两个不同的概念:前者是渲染层的能力,后者是客户端可调用的 RPC 接口。Start 中 RSC 仍是实验性特性,生产项目需谨慎评估。

准备好开始了吗?

进入下一页,学习如何安装 TanStack Start 并创建你的第一个应用!

On this page