用途:这是一份从 Next.js App Router 迁移到 TanStack Start 的分步检查清单,按顺序执行任务。
主要能力:提供概念映射表(如 app/page.tsx 对应 src/routes/index.tsx、[param] 对应 $param、Server Actions 对应 createServerFn),并给出 Vite 配置、路由工厂、根路由、文件路由、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 替代 next.config.js,其中 tanstackStart() 必须在 viteReact() 之前;用 src/start.ts 的 createMiddleware() 替代 middleware.ts。
关键限制:TanStack Start 默认同构,所有代码在两个环境运行,仅 createServerFn 内为纯服务端逻辑;不使用 "use server"/"use client" 指令;类型完全推断,不要强制转换或标注;Link 参数用 params 属性传入,不得拼进 to 字符串;需移除 next/* 导入、app/ 与 next.config 文件;其余细节资料暂未提供。