路由组(route-groups)
路由组是一个文件夹约定,允许你按类别或团队组织路由。
约定
可以通过将文件夹名称包装在括号中来创建路由组:(folderName)
。
此约定表示该文件夹用于组织目的,不应包含在路由的 URL 路径中。


用例
- 按团队、关注点或功能组织路由。
- 定义多个根布局。
- 选择特定的路由段共享布局,同时保持其他路由段不共享。
注意事项
- 完整页面加载:如果你在使用不同根布局的路由之间导航,它将触发完整页面重新加载。例如,从使用
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。