用途:这是 TanStack Router 的入门/总览技能,用于理解框架无关的核心概念,包括路由树、createRouter、createRoute、createRootRoute、createRootRouteWithContext、addChildren 等,并帮助选择一个主攻子技能而非加载全部目录。
主要能力:涵盖搜索参数(读取、写入、校验、转换)、路径参数(动态段、splat、可选参数)、导航(Link、useNavigate、预加载、阻塞)、数据加载(loader、SWR 缓存、context、延迟数据)、鉴权与守卫(beforeLoad 重定向、RBAC)、代码分割、404 与错误处理、类型安全与 SSR 等子技能。
关键约束:类型完全推断,不要强制转换或标注推断值;该路由为客户端优先,loader 默认在客户端运行,不是 Remix/Next.js 的仅服务端模式,不要混淆其 API。
使用方式:需要查询参数进入 search-params 子技能;动态段进入 path-params;链接与程序化导航进入 navigation;路由取数进入 data-loading;鉴权进入 auth-and-guards;包体积优化进入 code-splitting;错误与 404 进入 not-found-and-errors;TS 问题进入 type-safety;服务端渲染进入 ssr。仅在任务跨越真实边界时才加载第二个子技能。
完成检查:重构路由应重命名或移动文件,不手改生成的 createFileRoute 路径,重新生成 routeTree.gen.ts,并更新链接、重定向、from 收窄、参数与测试,运行类型测试和生产构建。响应结构变更需同步更新模型、校验、序列化与消费端,并在测试中断言实际载荷。
限制:资料未提供收费、价格与具体平台支持信息;版本针对 @tanstack/router-core v1.171.15,splat 使用 $,* 兼容别名将在 v2 移除。