一句话结论:route 是 URL 与代码之间的映射规则,page 是这条规则匹配成功后 渲染出来的界面。 route 决定「访问哪个地址时执行哪段代码」,page 决定「用户最终看到什么」。
这两个词本身并不冲突,容易混淆是因为不同框架里它们的形态不一样,下面分开说。
在 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 本身没有 “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>; }
由此可以推出三点区别:
index 路由都属于这种。/users/:id 和 /users/:id/edit 可以用同一个组件,靠参数或子路由区分。page.tsx 就是页面,看到 route.ts 就是接口。<Route> 是规则,element 里放的那个组件才是 page。page.tsx 与 route.ts 是同级互斥的两种文件约定<Route> 是规则,页面组件就是你写的那个组件