用途:面向 React 应用提供类型安全、基于文件的路由方案,覆盖安装、路由配置、类型化参数/搜索、布局与导航。
主要能力:支持自动代码分割(v1.x+,autoCodeSplitting: true),将路由配置、loader、搜索参数校验、beforeLoad 等关键部分与组件、错误/加载/404 组件分离,减小初始包体;基于 src/routes 目录的文件约定(__root.tsx、index.tsx、$param.tsx、_layout.tsx、route.lazy.tsx)生成路由树;支持虚拟文件路由、路由分组、布局路由、类型化 useParams/useSearch/useLoaderData、getRouteApi 跨文件访问、loader 数据获取、与 TanStack Query 集成、Link 声明式导航与 useNavigate 编程式导航、preload 预加载、重定向鉴权、路由上下文、错误与加载状态组件、DevTools。
用法:安装 pnpm add @tanstack/react-router 与 pnpm add -D @tanstack/router-plugin,在 vite.config.ts 中注册 TanStackRouterVite() 以生成路由树;在 src/main.tsx 中用 createRouter({ routeTree }) 创建路由器并经 RouterProvider 渲染,通过 declare module 注册路由以获得类型安全。动态参数用 $param.tsx 命名,搜索参数可用 Zod 的 validateSearch 校验,数据获取写在 loader 中。
限制:资料未提供收费、价格、平台与效果信息;版本与具体 API 行为请以官方文档为准。