Vercel React 最佳實踐 是做什麼的?
由 Vercel 維護的 React 與 Next.js 應用程式完整效能優化指南。包含 45 條規則,橫跨 8 個類別,並根據影響程度排序,以引導自動重構與程式碼生成。
何時套用
在以下情況參考這些指南:
- 撰寫新的 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- 將耗時的工作提取到記憶化的元件中rerender-dependencies- 在 effect 中使用基本型別作為相依性rerender-derived-state- 訂閱衍生的布林值,而非原始值rerender-functional-setstate- 使用函數式 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- 使用內嵌 script 處理僅客戶端資料rendering-activity- 使用 Activity 元件來控制顯示/隱藏rendering-conditional-render- 使用三元運算子,而非&&來進行條件渲染
7. JavaScript 效能(低中)
js-batch-dom-css- 透過 class 或 cssText 分組 CSS 變更js-index-maps- 為重複查詢建立 Mapjs-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- 將 RegExp 創建提升到迴圈外部js-min-max-loop- 使用迴圈找出最小/最大值,而非 sortjs-set-map-lookups- 使用 Set/Map 進行 O(1) 查詢js-tosorted-immutable- 使用toSorted()保持不可變性
8. 進階模式(低)
advanced-event-handler-refs- 將事件處理器儲存在 refs 中advanced-use-latest- useLatest 用於穩定的回呼 refs
如何使用
閱讀個別規則檔案以取得詳細說明和程式碼範例:
rules/async-parallel.md
rules/bundle-barrel-imports.md
rules/_sections.md
每個規則檔案包含:
- 規則重要性的簡要說明
- 錯誤的程式碼範例及說明
- 正確的程式碼範例及說明
- 其他相關背景資訊與參考資料
完整彙編文件
如需包含所有規則展開的完整指南,請參閱:AGENTS.md