路由群組 (Route Groups)

路由群組是一種資料夾命名慣例，可讓您按類別或團隊來組織路由。

命名慣例

建立路由群組的方式是將資料夾名稱用括號包起來：(資料夾名稱)。

此慣例表示該資料夾僅用於組織目的，不應包含在路由的 URL 路徑中。

使用情境

• 按團隊、關注點或功能組織路由
• 定義多個 根佈局 (root layouts)
• 讓特定路由區段選擇共享佈局，同時排除其他區段

注意事項

• 完整頁面載入：若在使用了不同根佈局的路由之間導航，會觸發完整頁面重新載入。例如從使用 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。