Menu

Route Groups

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