用途:在 React 单页应用(Vite、Webpack、Rspack)中使用 TanStack Router 实现类型安全路由,不适用于 Next.js(应使用 App Router)。
主要能力:基于文件的路由与自动生成类型;loader 数据加载;搜索参数校验(Zod、Valibot);与 TanStack Query 原生集成,支持缓存、mutation、乐观更新;预加载(intent、render);嵌套布局与 Outlet;错误边界与 404;代码分割;路由上下文依赖注入;认证守卫与 RBAC;SSR(TanStack Start);DevTools。
使用方式:遵循 SOLID 模块结构,路由定义放在 routes/,共享配置放在 modules/cores/lib/router/,功能模块含 interfaces/、queries/、components/。关键规则:始终使用基于文件的路由;始终校验搜索参数(Zod v4 直接传 schema,Zod v3 用 zodValidator);始终使用 Route.useLoaderData() 而非全局 useLoaderData;注册路由类型 declare module '@tanstack/react-router';优先用 loader 而非 useEffect;集成 TanStack Query;遵循 SOLID 架构。
适用场景:需要类型安全路由与搜索参数校验的 React SPA;从 React Router 迁移(useParams()→Route.useParams(),loader 函数→loader 选项,action 函数→TanStack Query mutation);带过滤/分页的页面;嵌套布局仪表盘;受保护路由。
限制:不覆盖状态管理(react-state)与表单(react-forms),这些是独立技能;不适用于 Next.js 路由。资料未提供具体收费、价格或平台信息。