React / 系统课时

组织嵌套路由

组织嵌套路由

App Router 直接用目录层级表达 URL 层级。本节通过商品、订单和历史订单三个页面建立多级路由,并验证目录、page.tsx 与最终访问地址之间的对应关系。

学习目标

  • 能根据业务 URL 设计 app 目录中的多级路由结构
  • 理解目录段与 page.tsx 在路由匹配中的不同职责
  • 能运行并验证三级嵌套路由是否正确生效

路由层级如何映射目录

在 App Router 中,app 下的文件夹表示路由段,多个文件夹依次嵌套就形成多级 URL。真正让某个地址能够渲染页面的是该段中的 page.tsx,而中间目录可以只承担路径分组作用。

例如 app/products/orders/history/page.tsx 对应 /products/orders/history。如果 products 和 orders 中也分别存在 page.tsx,那么 /products 与 /products/orders 也会成为可直接访问的页面。

嵌套路由目录与 URL 的映射

构建三级业务页面

下面是一个片段示例。三个模块需要分别保存到注释标出的文件中,不能合并成同一个 page.tsx 文件。

tsx
// app/products/page.tsx
export default function ProductsPage() {
  return <main><h1>商品中心</h1></main>;
}

// app/products/orders/page.tsx
export default function OrdersPage() {
  return <main><h1>订单列表</h1></main>;
}

// app/products/orders/history/page.tsx
export default function OrderHistoryPage() {
  return <main><h1>历史订单</h1></main>;
}

预期结果:启动 Next.js 开发服务器后,三个组件分别出现在 /products、/products/orders 和 /products/orders/history。访问最深层地址时,页面能够看到“历史订单”标题。

可以直接从终端验证最深层页面。将 <PORT> 替换为开发服务器实际监听端口,通常为 3000。

bash
curl -s http://localhost:<PORT>/products/orders/history | grep -o "历史订单"

预期输出:

text
历史订单

判断一个目录是否对应页面

目录存在并不等于该地址一定能够显示页面。app/products/orders 可以作为后代路由的中间层,但只有存在 app/products/orders/page.tsx 时,访问 /products/orders 才会得到这个路由段自己的页面内容。

因此设计目录时应先确定业务 URL,再逐段建立文件夹,最后只在需要直接访问的地址放置 page.tsx。不要为了整理普通 React 组件而不断增加路由段;可复用组件可以放在独立组件目录中,再由页面导入。

用业务含义控制路由深度

嵌套路由最适合表达天然具有上下级关系的资源,例如“项目 → 设置 → 成员”或“商品 → 订单 → 历史记录”。目录名称应优先反映 URL 和业务语义,而不是页面视觉区域的名称。

当一个页面只能通过父级上下文理解时,继续嵌套通常是合理的;如果目录只是为了存放按钮、表单或卡片组件,就不应把这些实现细节变成 URL。这样路由结构才能长期保持可读且容易维护。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

组织嵌套路由

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通