路由组 (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。