TanStack Router 导览

如果说 TanStack Start 是外层框架，那 TanStack Router 就是它的心脏。

而且它不只给 Start 用。哪怕你完全不碰 Start，只做 React SPA，Router 本身也已经是一套非常完整、并且很有个性的路由方案。

官方 Overview 里给 Router 的定位很明确：它既能做 file-based routing，也能做 code-based routing；支持类型安全导航、嵌套路由、Loader、预加载、文档头管理、搜索参数建模、SSR，以及和 TanStack Query 这类客户端缓存工具的协作。

📄️Router 基础

TanStack Router 第一眼看上去像是“又一个文件路由方案”。如果只看到这里，你大概率会低估它。

📄️Router 进阶

如果说文件路由只是入口，那 search params、loader、preloading 才是 TanStack Router 真正开始拉开差距的地方。

📄️Router SSR

很多人第一次意识到这一点时都会愣一下：

这组内容建议怎么读

1. 先看核心概念

• Router 基础

这一篇先把根路由、文件路由、嵌套、路径参数、目录习惯讲清楚。

2. 再看更有辨识度的部分

• Router 进阶

真正让 TanStack Router 和很多传统路由方案拉开差距的，往往就在这里。

3. 最后再看 SSR

• Router SSR

很多人直到看到这篇，才会彻底明白“Router 不等于只能做客户端导航”。

Router 最值得留意的三个点

• 类型安全 做得很深，不只是 params，连导航和 search params 都在认真管
• URL 被当成一等状态容器，而不是一个被动字符串
• file-based 和 code-based 可以并存，不会逼你选边站死