Next.js 最佳實務 是做什麼的?
適用於 Next.js App Router 開發的原則。
1. 伺服器與用戶端元件
決策樹
是否需要...?
│
├── useState、useEffect、事件處理器
│ └── 用戶端元件('use client')
│
├── 直接資料擷取,無需互動
│ └── 伺服器元件(預設)
│
└── 兩者都需要?
└── 拆分:伺服器父元件 + 用戶端子元件
預設用法
| 類型 | 用途 |
|---|
| 伺服器 | 資料擷取、佈局、靜態內容 |
| 用戶端 | 表單、按鈕、互動式 UI |
2. 資料擷取模式
擷取策略
| 模式 | 用途 |
|---|
| 預設 | 靜態(建置時快取) |
| 重新驗證 | ISR(基於時間的重新整理) |
| 不儲存 | 動態(每次請求) |
資料流程
| 來源 | 模式 |
|---|
| 資料庫 | 伺服器元件擷取 |
| API | 使用快取的 fetch |
| 使用者輸入 | 客戶端狀態 + 伺服器動作 |
3. 路由原則
檔案約定
| 檔案 | 用途 |
|---|
page.tsx | 路由 UI |
layout.tsx | 共享佈局 |
loading.tsx | 載入狀態 |
error.tsx | 錯誤邊界 |
not-found.tsx | 404 頁面 |
路由組織
| 模式 | 用途 |
|---|
路由群組 (name) | 組織但不影響 URL |
並行路由 @slot | 多個同層級頁面 |
攔截路由 (.) | 模態疊層 |
4. API 路由
路由處理器
| 方法 | 用途 |
|---|
| GET | 讀取資料 |
| POST | 建立資料 |
| PUT/PATCH | 更新資料 |
| DELETE | 刪除資料 |
最佳實務
- 使用 Zod 驗證輸入
- 回傳適當的狀態碼
- 妥善處理錯誤
- 盡可能使用 Edge Runtime
5. 效能原則
圖片最佳化
- 使用 next/image 元件
- 為上方折頁設定優先級
- 提供模糊佔位圖
- 使用響應式尺寸
捆綁最佳化
- 對重型元件使用動態導入
- 基於路由的程式碼拆分(自動)
- 使用捆綁分析器進行分析
6. 中繼資料
靜態 vs 動態
| 類型 | 用途 |
|---|
| 靜態匯出 | 固定中繼資料 |
| generateMetadata | 每個路由動態產生 |
必要標籤
- title(50-60 個字元)
- description(150-160 個字元)
- Open Graph 圖片
- Canonical URL
7. 快取策略
快取層級
| 層級 | 控制方式 |
|---|
| 請求 | fetch 選項 |
| 資料 | revalidate/tags |
| 完整路由 | 路由設定 |
重新驗證
| 方法 | 用途 |
|---|
| 基於時間 | revalidate: 60 |
| 按需 | revalidatePath/Tag |
| 無快取 | no-store |
8. 伺服器動作
使用案例
最佳實務
- 標記 'use server'
- 驗證所有輸入
- 回傳型別化的回應
- 處理錯誤
9. 反模式
| ❌ 不要這樣做 | ✅ 應該這樣做 |
|---|
| 到處使用 'use client' | 預設使用伺服器元件 |
| 在用戶端元件中擷取資料 | 在伺服器元件中擷取資料 |
| 跳過載入狀態 | 使用 loading.tsx |
| 忽略錯誤邊界 | 使用 error.tsx |
| 大型客戶端捆綁 | 動態導入 |
10. 專案結構
app/
├── (marketing)/ # 路由群組
│ └── page.tsx
├── (dashboard)/
│ ├── layout.tsx # 儀表板佈局
│ └── page.tsx
├── api/
│ └── [resource]/
│ └── route.ts
└── components/
└── ui/
請記住: 預設使用伺服器元件是有原因的。從那裡開始,只有在必要時才加入客戶端元件。