NNext.js 中文网 GitHub

路由组(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。
Next.js 中文网