技术比较
TanStack Router vs React Router：编译时安全 vs 运行时灵活性
TanStack Router 在构建时检查路由；React Router 在运行时检查。对于大型应用程序，这个差异是巨大的。
2026-07-01
Huifer · Indie Developer→ /about
我在大型应用（30+ 路由）中使用过两者： - React Router：升级到 v7 时迁移痛苦，很多字符串路径需要手动检查 - TanStack Router：路由重构只需要 IDE 重命名，类型错误会立即显示 对于大型项目，TanStack Router 的类型安全是生产力保障。但 React Router 的生态和招聘市场是现实优势。 下文，我会分析"开发体验 vs. 生态"的权衡。
TL;DR
- 如果您想要编译时类型安全，请选择 TanStack Router — 损坏的链接会在构建时失败，而不是影响您的用户。
- 如果您想要一个成熟的生态系统并且对现有应用程序进行最小重构，请选择 React Router。
- TanStack Router 与 TanStack Start 原生集成 SSR；React Router 需要手动设置。
- 两者都是生产就绪的；选择是 DX 与生态系统之间的权衡。
| 维度 | TanStack Router | React Router |
|---|---|---|
| 路由类型安全 | 完整编译时 | 部分 |
| 搜索参数 | 全类型化 + zod | 字符串 |
| 数据加载 | Loaders + Query | Loaders + Actions |
| 包体积 | 相当 | 相当 |
| 生态系统 | 增长中 | 无处不在 |
| SSR | 通过 TanStack Start | 通过 Remix/各框架 |
类型安全
TanStack Router 在编译时校验路由路径、参数和搜索参数——包括用 Zod schema。
React Router 编译时校验较少。你会在更晚的时候才抓到 bug。
搜索参数
TanStack Router 把搜索参数当作一等公民的类型化状态。
React Router 把搜索参数留成字符串，由你自己解析。
TanStack Ship 的定位
TanStack Ship 大量使用 TanStack Router——SaaS 基线里的每条路由都是类型安全的，每个搜索参数都经 Zod 校验。想看 TanStack Router 在真实生产 SaaS（而不是教程）里的用法，TanStack Ship 就是参考实现。
常见问题
两者兼容吗？
角色相同，二选一。
第一次做 React 应用选哪个？
React Router——生态更大。
大型应用选哪个？
TanStack Router——超过 30 条路由后类型安全开始回本。
TanStack Router 能脱离 TanStack Start 用吗？
能，独立使用。
React Router 7 就是 Remix 吗？
合并了。同一团队，统一了定位。