跳到內容

路由組

路由組是一種資料夾約定,允許你按類別或團隊組織路由。

約定

透過將資料夾名稱用括號包裹來建立路由組:(folderName)

此約定表明該資料夾用於組織目的,並且**不應包含**在路由的 URL 路徑中。

An example folder structure using route groups

用例

  • 按團隊、關注點或功能組織路由。
  • 定義多個根佈局
  • 選擇特定的路由段共享佈局,而將其他路由段排除在外。

注意事項

  • 完整頁面載入:如果你在使用不同根佈局的路由之間導航,它將觸發完整頁面重新載入。例如,從使用 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。