路由组 (Route Groups)

路由组 (Route Groups) 是一种文件夹命名约定,允许您按类别或团队组织路由。

命名约定

通过在文件夹名称外加括号即可创建路由组:(folderName)

此约定表示该文件夹仅用于组织目的,不应包含在路由的 URL 路径中。

使用路由组的文件夹结构示例

使用场景

  • 按团队、业务或功能组织路由
  • 定义多个 根布局 (root layouts)
  • 使特定路由段共享布局,同时保持其他路由独立

注意事项

  • 整页加载:如果在使用不同根布局的路由之间导航,将触发整页重新加载。例如,从使用 app/(shop)/layout.js/cart 导航到使用 app/(marketing)/layout.js/blog。此情况适用于多个根布局的情况。
  • 路径冲突:不同组中的路由不应解析为相同的 URL 路径。例如 (marketing)/about/page.js(shop)/about/page.js 都会解析到 /about 并导致错误。
  • 顶级根布局:如果使用多个根布局但没有顶级 layout.js 文件,请确保您的主页路由 (/) 定义在其中一个路由组中,例如 app/(marketing)/page.js。

On this page