Vercel React 最佳實務
由 Vercel 維護的 React 與 Next.js 應用程式全面效能最佳化指南。包含依影響程度優先排序的 8 大類別共 45 條規則,可引導自動重構與程式碼產生。
何時套用
請在以下情況參考這些準則:
- 撰寫新的 React 元件或 Next.js 頁面
- 實作資料擷取(用戶端或伺服器端)
- 檢視程式碼以找出效能問題
- 重構現有的 React/Next.js 程式碼
- 最佳化套件大小或載入時間
依優先順序排列的規則類別
| 優先順序 | 類別 | 影響程度 | 前綴 |
|---|---|---|---|
| 1 | 消除請求瀑布 | 關鍵 | async- |
| 2 | 套件大小最佳化 | 關鍵 | bundle- |
| 3 | 伺服器端效能 | 高 | server- |
| 4 | 用戶端資料擷取 | 中高 | client- |
| 5 | 重新渲染最佳化 | 中 | rerender- |
| 6 | 渲染效能 | 中 | rendering- |
| 7 | JavaScript 效能 | 低中 | js- |
| 8 | 進階模式 | 低 | advanced- |
快速參考
1. 消除請求瀑布(關鍵)
async-defer-await- 將 await 移至實際使用的分支中async-parallel- 針對獨立操作使用Promise.all()async-dependencies- 對於部分相依性使用 better-allasync-api-routes- 在 API 路由中儘早啟動 Promise,後續再 awaitasync-suspense-boundaries- 使用 Suspense 來串流內容
2. 套件大小最佳化(關鍵)
bundle-barrel-imports- 直接匯入,避免使用 barrel 檔案bundle-dynamic-imports- 針對大型元件使用next/dynamicbundle-defer-third-party- 在 hydration 之後載入分析/日誌功能bundle-conditional- 僅在功能啟用時載入模組bundle-preload- 在滑鼠懸停/聚焦時預載以提升感知速度
3. 伺服器端效能(高)
server-cache-react- 使用React.cache()進行每個請求的去重server-cache-lru- 使用 LRU 快取進行跨請求解讀取server-serialization- 最小化傳遞給用戶端元件的資料量server-parallel-fetching- 重構元件以平行化擷取操作server-after-nonblocking- 使用after()執行非封鎖操作
4. 用戶端資料擷取(中高)
client-swr-dedup- 使用 SWR 自動進行請求去重client-event-listeners- 對全域事件監聽器進行去重
5. 重新渲染最佳化(中)
rerender-defer-reads- 不要訂閱僅在回呼中使用的狀態rerender-memo- 將昂貴的工作提取到已 memo 化的元件中rerender-dependencies- 在 effect 中使用基本型別相依性rerender-derived-state- 訂閱衍生的布林值,而非原始值rerender-functional-setstate- 使用 functional setState 以獲得穩定的回呼rerender-lazy-state-init- 對昂貴的值傳遞函式給useStatererender-transitions- 使用startTransition處理非緊急更新
6. 渲染效能(中)
rendering-animate-svg-wrapper- 對 div 包裝器進行動畫,而非 SVG 元素本身rendering-content-visibility- 對長列表使用content-visibilityrendering-hoist-jsx- 將靜態 JSX 提取到元件外部rendering-svg-precision- 降低 SVG 座標精度rendering-hydration-no-flicker- 使用內嵌腳本來處理僅限用戶端的資料rendering-activity- 使用 Activity 元件來控制顯示/隱藏rendering-conditional-render- 使用三元運算子而非&&進行條件渲染
7. JavaScript 效能(低中)
js-batch-dom-css- 透過類別或cssText批次處理 CSS 變更js-index-maps- 建立 Map 以進行重複查詢js-cache-property-access- 在迴圈中快取物件屬性js-cache-function-results- 在模組層級的 Map 中快取函式結果js-cache-storage- 快取localStorage/sessionStorage讀取js-combine-iterations- 將多次的 filter/map 合併為一個迴圈js-length-check-first- 在進行昂貴的比較前先檢查陣列長度js-early-exit- 在函式中及早返回js-hoist-regexp- 將正則表達式的建立提升到迴圈外部js-min-max-loop- 使用迴圈尋找最小值/最大值,而非排序js-set-map-lookups- 使用 Set/Map 以達到 O(1) 查詢js-tosorted-immutable- 使用toSorted()以維持不可變性
8. 進階模式(低)
advanced-event-handler-refs- 將事件處理器儲存在 ref 中advanced-use-latest- 使用useLatest來獲得穩定的回呼 ref
如何使用
閱讀個別規則檔案以取得詳細說明和程式碼範例:
rules/async-parallel.md
rules/bundle-barrel-imports.md
rules/_sections.md
每個規則檔案包含:
- 為何重要的簡要說明
- 附說明的錯誤程式碼範例
- 附說明的正確程式碼範例
- 其他背景資訊與參考資料
完整彙編文件
如需包含所有規則展開說明的完整指南,請參閱:AGENTS.md