目录

page 和 route 的区别

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

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

一、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>;
}

由此可以推出三点区别:

三、快速判断口诀

四、小结