src 目錄

除了在專案根目錄中建立特殊的 Next.js apppages 目錄外,Next.js 也支援將應用程式程式碼放在 src 目錄下的常見模式。

這種方式可將應用程式程式碼與主要位於專案根目錄的專案設定檔分開,這是某些個人或團隊偏好的做法。

要使用 src 目錄,請將 app 路由資料夾或 pages 路由資料夾分別移動到 src/appsrc/pages

包含 `src` 目錄的範例資料夾結構

須知事項

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