====== 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 仪表盘
;
}
**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 定义「路径 → 渲染什么」
} />
} />
} />
// UserPage 就是那个 page,靠 useParams 拿到 :id
function UserPage() {
const { id } = useParams();
return 用户 {id}
;
}
由此可以推出三点区别:
* **一个 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 里看到 ''%%%%'' 是规则,''element'' 里放的那个组件才是 page。
===== 四、小结 =====
* route = 映射规则(URL ↔ 代码)
* page = 渲染结果(UI)
* Next.js App Router:''page.tsx'' 与 ''route.ts'' 是同级互斥的两种文件约定
* React Router:''%%%%'' 是规则,页面组件就是你写的那个组件