Vercel React ベストプラクティス
React および Next.js アプリケーション向けの包括的なパフォーマンス最適化ガイド。Vercel が維持しています。自動リファクタリングとコード生成を導くために、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-all を使用するasync-api-routes- API ルートでは Promise を早期に開始し、遅れて await するasync-suspense-boundaries- Suspense を使用してコンテンツをストリーミングする
2. バンドルサイズの最適化(重大)
bundle-barrel-imports- バレルファイルを避け、直接インポートするbundle-dynamic-imports- 重いコンポーネントには next/dynamic を使用するbundle-defer-third-party- 分析/ログはハイドレーション後に読み込む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- 副作用の依存関係にはプリミティブ値を使用するrerender-derived-state- 生の値ではなく、派生した真偽値を購読するrerender-functional-setstate- 安定したコールバックには関数型 setState を使用するrerender-lazy-state-init- 高コストな値には関数を useState に渡すrerender-transitions- 緊急でない更新には startTransition を使用する
6. レンダリングパフォーマンス(中)
rendering-animate-svg-wrapper- SVG 要素ではなく div ラッパーをアニメーションさせるrendering-content-visibility- 長いリストには content-visibility を使用するrendering-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 を 1 つのループに結合するjs-length-check-first- 高コストな比較の前に配列の長さを確認するjs-early-exit- 関数から早期に return するjs-hoist-regexp- RegExp の生成をループの外に移動するjs-min-max-loop- sort ではなくループを使用して最小/最大値を求めるjs-set-map-lookups- O(1) 検索には Set/Map を使用するjs-tosorted-immutable- 不変性のために toSorted() を使用する
8. 高度なパターン(低)
advanced-event-handler-refs- イベントハンドラーを ref に格納するadvanced-use-latest- 安定したコールバック参照には useLatest を使用する
使用方法
個別のルールファイルで詳細な説明とコード例を参照してください:
rules/async-parallel.md
rules/bundle-barrel-imports.md
rules/_sections.md
各ルールファイルには以下が含まれます:
- それが重要な理由の簡単な説明
- 説明付きの誤ったコード例
- 説明付きの正しいコード例
- 追加のコンテキストと参考文献
完全なコンパイル済みドキュメント
すべてのルールを展開した完全なガイド:AGENTS.md