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/