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?
任何框架的 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 并创建你的第一个应用!