用途:该技能面向 TanStack Start 应用的部署与渲染配置,基于 Vite 与 Nitro,覆盖托管平台接入、SSR 控制、静态预渲染和 SEO。
主要能力:支持 Cloudflare Workers、Netlify、Vercel、Railway、Node.js/Docker、Bun 等部署目标;可按路由设置 ssr 为 true、false 或 'data-only',也可用函数形式按 params/search 运行时决定;支持在 src/start.ts 通过 defaultSsr 修改全局默认;支持构建期静态预渲染(prerender 的 enabled、crawlLinks、concurrency、failOnError);支持 head 中配置 meta、基于 loaderData 的动态 meta、JSON-LD 结构化数据,以及通过服务端路由生成动态 sitemap。
使用方式:Cloudflare Workers 需安装 @cloudflare/vite-plugin 与 wrangler,并在 wrangler.jsonc 中设置 main 为 @tanstack/react-start/server-entry,部署命令为 npx wrangler login && pnpm run deploy;Netlify 使用 @netlify/vite-plugin-tanstack-start,部署命令为 npx netlify deploy;Nitro 方案安装 nitro@npm:nitro-nightly@latest,构建启动为 npm run build && node .output/server/index.mjs;Bun 需在 nitro 中设置 preset: 'bun'。
限制与注意:Cloudflare Workers 的 env 按请求注入,模块作用域读取 process.env.X 会得到 undefined,应使用 cloudflare:workers 的 env 绑定或在请求内读取;Cloudflare 需开启 nodejs_compat;Bun 部署要求 React 19,React 18 应使用 Node.js 部署;子路由只能比父路由更严格,父级 ssr: false 时子级无法升级为 true;动态路由预渲染需 crawlLinks 或显式 pages 配置。其他平台细节与收费信息暂未提供。