**这是本文档旧的修订版!**
page 和 route 的区别
一句话结论:route 是 URL 与代码之间的映射规则,page 是这条规则匹配成功后 渲染出来的界面。 route 决定「访问哪个地址时执行哪段代码」,page 决定「用户最终看到什么」。
- route(路由)——配置层:路径 → 组件 / 处理函数。
- page(页面)——UI 层:真正被渲染出来的那块界面。
这两个词本身并不冲突,容易混淆是因为不同框架里它们的形态不一样,下面分开说。
一、Next.js App Router 里:page.tsx 与 route.ts
在 Next.js 的 app/ 目录下,page 和 route 是两种并列的文件约定,都靠目录名决定 URL:
| 对比项 | page.tsx | route.ts |
|---|---|---|
| 角色 | 页面 | Route Handler(接口 / 路由处理器) |
| 导出方式 | 默认导出 export default function Page() | 按 HTTP 方法命名导出,如 export async function GET() |
| 返回什么 | React 元素(UI) | Response / NextResponse(数据) |
| URL 来源 | 所在目录的路径 | 所在目录的路径 |
| 是否写 JSX | 必须写 | 一般不写 |
| 是否套 layout | 会,被包在 layout.tsx 里 | 不会,与 UI 无关 |
| 常见用途 | 展示页面 | 提供 API、Webhook、代理转发 |
典型结构:
app/
dashboard/
layout.tsx // 布局
page.tsx // → 页面 /dashboard
api/
users/
route.ts // → 接口 /api/users
page.tsx:渲染 UI,必须有默认导出
// app/dashboard/page.tsx
export default function DashboardPage() {
return <h1>仪表盘</h1>;
}
route.ts:处理请求,按方法名导出,不渲染 UI
// app/api/users/route.ts import { NextResponse } from "next/server"; export async function GET() { return NextResponse.json({ users: [] }); } export async function POST(request) { const body = await request.json(); return NextResponse.json({ ok: true, body }, { status: 201 }); }
关键限制:同一个路由段里 不能同时存在 page.tsx 和 route.ts,否则路径冲突、构建报错。 也就是说,一个地址「要么是页面,要么是接口」,二选一。
旧的 Pages Router 是同样的道理,只是用目录来区分:pages/about.tsx 是页面,pages/api/hello.ts 是接口。
二、React Router 里:Route 是规则,page 是组件
React Router 本身没有 “page” 这个关键字——页面就是你写的普通组件,<Route> 才是路由规则。
// Route 定义「路径 → 渲染什么」
<Routes>
<Route path="/" element={<Home />} />
<Route path="/users/:id" element={<UserPage />} />
<Route path="*" element={<NotFound />} />
</Routes>
// UserPage 就是那个 page,靠 useParams 拿到 :id
function UserPage() {
const { id } = useParams();
return <div>用户 {id}</div>;
}
由此可以推出三点区别:
- 一个 route 可以没有 page:纯重定向、只负责嵌套的 layout route、
index路由都属于这种。 - 一个 page 可以被多个 route 复用:
/users/:id和/users/:id/edit可以用同一个组件,靠参数或子路由区分。 - route 是 URL 层面的概念,page 是组件层面的概念:route 决定地址,page 决定这个地址长什么样。
三、快速判断口诀
- 「这东西跟 URL 地址有关吗?」有关 → 属于 route。
- 「用户能看到它吗?」能看到 → 属于 page。
- Next.js 里看到
page.tsx就是页面,看到route.ts就是接口。 - React Router 里看到
<Route>是规则,element里放的那个组件才是 page。
四、小结
- route = 映射规则(URL ↔ 代码)
- page = 渲染结果(UI)
- Next.js App Router:
page.tsx与route.ts是同级互斥的两种文件约定 - React Router:
<Route>是规则,页面组件就是你写的那个组件