用途:这是一份从 Next.js App Router 迁移到 TanStack Start 的分步迁移清单,需按顺序完成各任务。
主要能力:提供概念映射表与代码转换步骤,涵盖 Vite 配置替换 next.config.js、路由工厂、布局转为根路由、页面转为文件路由、Server Actions 转为 Server Function、数据获取、API 路由、导航、中间件与元数据/SEO 的转换,并附迁移后检查项与常见错误。
必要用法:先建迁移分支并安装依赖: git checkout -b migrate-to-tanstack-start npm i @tanstack/react-start @tanstack/react-router npm i -D vite @vitejs/plugin-react npm uninstall next @next/font @next/image 配置 vite.config.ts 时 tanstackStart() 必须在 react() 之前。
限制与注意:TanStack Start 默认同构,全部代码在两端运行,除非使用 createServerFn;不使用 "use server"/"use client";类型完全推断,不要强转或标注;动态段用 $param 而非 [param];Link 不可把参数插值进 to,需用 params 属性。