用途:TanStack Start 是构建在 TanStack Router 与 Vite 之上的全栈 React 框架,提供 SSR、流式渲染、服务端函数(类型安全 RPC)、中间件、服务端路由与通用部署。本技能是入口,用于选择一个主要工作流,而非加载全部子技能。
主要能力与子技能:服务端函数(类型安全 RPC、数据获取与变更)、中间件(请求/函数中间件、上下文、鉴权)、服务端鉴权原语(会话、Cookie、OAuth、CSRF)、执行模型(同构执行与环境边界)、服务端路由(REST 端点)、部署(托管、SSR 模式、预渲染、SEO)。
关键约束:所有代码默认同构,在服务端与客户端都运行,loader 两端都会执行;仅服务端代码须用 createServerFn。它不是 Next.js,不要使用 getServerSideProps、"use server"、app/layout.tsx 等模式。类型完全推断,不要强制转换或标注推断值。
安装:npm i @tanstack/react-start @tanstack/react-router react react-dom;npm i -D vite @vitejs/plugin-react typescript。Vite 配置中 tanstackStart() 必须位于 react() 之前。需创建 getRouter() 路由工厂,根路由文档外壳须包含 HeadContent、Outlet 与 body 中的 Scripts。
常见错误:插件顺序颠倒、开启 verbatimModuleSyntax 导致服务端包泄漏到客户端、根路由缺少 Scripts 导致水合失败。
版本:面向 @tanstack/start-client-core v1.170.14。其余细节暂未提供。