路由组(Route Groups)
路由组可用于将 Next.js 应用程序划分为不同的部分。
路由组是一种文件夹约定,让你可以按类别或团队来组织路由。
约定#
可以通过将文件夹名称括在括号中创建路由组:(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。