react:page和route的区别

page 和 route 的区别

一句话结论:route 是 URL 与代码之间的映射规则,page 是这条规则匹配成功后 渲染出来的界面。 route 决定「访问哪个地址时执行哪段代码」,page 决定「用户最终看到什么」。

  • route(路由)——配置层:路径 → 组件 / 处理函数。
  • page(页面)——UI 层:真正被渲染出来的那块界面。

这两个词本身并不冲突,容易混淆是因为不同框架里它们的形态不一样,下面分开说。

在 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>;
}

由此可以推出三点区别:

  • 一个 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> 是规则,页面组件就是你写的那个组件

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • react/page和route的区别.1791969874.txt.gz
  • 最后更改: 2026/10/14 17:24
  • 由 张叶安