TanStack Start 中文文档
快速开始

TanStack Start 总览

注意

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

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

依赖

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

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

该用 TanStack Start 还是只用 TanStack Router?

任何框架的 90% 往往都取决于其路由器,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