src 目錄
除了在專案根目錄中建立特殊的 Next.js app
或 pages
目錄外,Next.js 也支援將應用程式程式碼放在 src
目錄下的常見模式。
這種方式可將應用程式程式碼與主要位於專案根目錄的專案設定檔分開,這是某些個人或團隊偏好的做法。
要使用 src
目錄,請將 app
路由資料夾或 pages
路由資料夾分別移動到 src/app
或 src/pages
。

須知事項
/public
目錄應保留在專案根目錄中。- 設定檔如
package.json
、next.config.js
和tsconfig.json
應保留在專案根目錄中。.env.*
檔案應保留在專案根目錄中。- 若根目錄中存在
app
或pages
,則src/app
或src/pages
將被忽略。- 若使用
src
目錄,建議同時移動其他應用程式資料夾如/components
或/lib
。- 若使用中介軟體 (Middleware),請確保其位於
src
目錄內。- 若使用 Tailwind CSS,需在
tailwind.config.js
檔案的 content 區段 中加入/src
前綴。- 若使用 TypeScript 路徑別名進行導入 (如
@/*
),應更新tsconfig.json
中的paths
物件以包含src/
。