Next.js Pages Router (傳統版本)
優先級:P0 (關鍵)
[!IMPORTANT] 此專案使用 Next.js Pages Router (
pages/目錄)。請勿使用 App Router 功能。
實作指南
- 路由架構:使用
pages/目錄。在_app.tsx中處理全域狀態/版面,在_document.tsx中處理自訂 HTML 屬性。使用方括號[id].tsx或捕獲所有路由[...slug].tsx定義動態路由。 - 資料擷取 (SSR/SSG):針對每次請求使用
getServerSideProps,或在建置時使用getStaticProps搭配getStaticPaths處理動態路由。將這些匯出為獨立的async函式。 - 邏輯隔離:絕不從伺服器端鉤子中
fetch自己的/api端點。應直接匯入服務層或資料庫邏輯。 - 客戶端鉤子:使用
next/router中的useRouter()進行導航與存取查詢參數。使用router.push()或<Link>進行客戶端路由。 - APIs:在
pages/api/中實作 API 路由,用於伺服器專用邏輯或 Webhook。使用適當的 HTTP 狀態碼來標準化回應。 - Next.js 15+ 相容性:留意 Next.js 15 升級;確保所有
getServerSideProps回傳的物件符合預期的PageProps。 - 樣式:透過 CSS Modules (
*.module.css) 或 Tailwind CSS 標準化樣式。除非在_app.tsx中匯入,否則避免使用全域 CSS。