TanStack Start 1.0 正式稳定：React 全栈开发多了一个新选择

TanStack Start 的重点不是重新发明 React，而是让开发者能明确决定代码在哪里运行，同时保留熟悉的路由、数据加载和客户端交互方式。

一个从路由长出来的全栈框架

很多人认识 TanStack，是从 Query、Table 或 Router 开始的。TanStack Start 则把 Router 的类型系统继续向服务端延伸，补上完整文档 SSR、流式渲染、Server Functions、API Routes、中间件和客户端/服务端构建。

这意味着，一个路由可以选择在服务端渲染、只在服务端加载数据，或者完全在客户端渲染。需要访问数据库、密钥或内部服务时，可以放进类型安全的 Server Function；普通页面交互仍然保留 React 应用的开发方式。

它更像是在 SPA 的开发模型上增加完整服务端能力，而不是要求开发者先接受一套全新的应用结构。

它和 Next.js 的差异在哪里

TanStack Start 并不是“换皮 Next.js”。两者都能做 SSR、服务端逻辑和全栈应用，但设计取向不同。

另一个明显区别是 React Server Components。Next.js 已经把 RSC 放在 App Router 的核心位置，而 TanStack Start 当前把它作为实验性、可选能力。团队甚至在官网项目中移除了 RSC，因为它增加了代码理解成本。

这不是谁一定更先进，而是两套取舍：如果项目依赖成熟的 Next.js 生态、平台能力和 RSC，没必要因为 1.0 就立刻迁移；如果你更在意类型安全、运行位置可控、接近 SPA 的开发体验和部署自由，TanStack Start 值得进入技术选型。

如何快速试一下

根据官方文档，新项目可以直接运行：

npx @tanstack/cli@latest create

CLI 会让你选择包管理器，并可选加入 Tailwind CSS、ESLint 等配置。官方还准备了 Basic、React Query、Clerk、Supabase、WorkOS 等示例，可以先在 StackBlitz 查看，再决定是否本地创建。

如果准备从 Next.js 迁移，不建议机械地重命名路由文件。官方迁移指南特别提醒，要先记录 URL、重定向、缓存、鉴权、Metadata、Server Actions 和部署行为，再逐项替换框架边界。尤其是 RSC 使用较重的项目，需要先确认 TanStack Start 当前的实验性支持是否满足要求。

现在适合直接用吗

1.0 的意义，是核心 API 已经获得稳定承诺，不再只是“可以尝试”的 RC 版本。认证、数据库、监控和部署生态也已经出现 Clerk、WorkOS、Prisma、Sentry、Cloudflare、Render 等集成。

但“稳定”不等于“适合所有项目”。已有 Next.js 项目如果运行良好，迁移成本可能高于收益；重度依赖 RSC、Next.js 图片优化或平台缓存能力的项目，也要逐项评估替代方案。

对准备启动的新 React 全栈项目来说，TanStack Start 1.0 最值得关注的不是功能清单，而是它提供了另一种组合：类型优先、客户端优先、服务端能力按需加入，同时保留部署选择权。