Vercel React ベストプラクティス
React および Next.js アプリケーション向けの包括的なパフォーマンス最適化ガイド(Vercel 管理)。優先度別に分類された 8 カテゴリ、45 のルールを含み、自動リファクタリングやコード生成の指針となります。
適用タイミング
以下の場合にこれらのガイドラインを参照してください:
- 新しい React コンポーネントまたは Next.js ページを作成するとき
- データフェッチ(クライアントサイドまたはサーバーサイド)を実装するとき
- パフォーマンス問題についてコードをレビューするとき
- 既存の React/Next.js コードをリファクタリングするとき
- バンドルサイズやロード時間を最適化するとき
ルールカテゴリ(優先度順)
| 優先度 | カテゴリ | 影響度 | プレフィックス |
|---|---|---|---|
| 1 | ウォーターフォールの解消 | CRITICAL | async- |
| 2 | バンドルサイズの最適化 | CRITICAL | bundle- |
| 3 | サーバーサイドパフォーマンス | HIGH | server- |
| 4 | クライアントサイドデータフェッチ | MEDIUM-HIGH | client- |
| 5 | 再レンダリングの最適化 | MEDIUM | rerender- |
| 6 | レンダリングパフォーマンス | MEDIUM | rendering- |
| 7 | JavaScript パフォーマンス | LOW-MEDIUM | js- |
| 8 | 高度なパターン | LOW | advanced- |
クイックリファレンス
1. ウォーターフォールの解消(CRITICAL)
async-defer-await- 実際に使用するブランチに await を移動するasync-parallel- 独立した操作には Promise.all() を使用するasync-dependencies- 部分的な依存関係には better-all を使用するasync-api-routes- API ルートでは Promise を早期に開始し、遅延して await するasync-suspense-boundaries- Suspense を使用してコンテンツをストリーミングする
2. バンドルサイズの最適化(CRITICAL)
bundle-barrel-imports- バレルファイルを避け、直接インポートするbundle-dynamic-imports- 重いコンポーネントには next/dynamic を使用するbundle-defer-third-party- アナリティクス/ロギングはハイドレーション後にロードするbundle-conditional- 機能が有効化されたときのみモジュールをロードするbundle-preload- ホバー時/フォーカス時にプリロードして知覚速度を向上する
3. サーバーサイドパフォーマンス(HIGH)
server-cache-react- React.cache() を使用してリクエストごとの重複排除を行うserver-cache-lru- LRU キャッシュを使用してリクエスト間のキャッシュを行うserver-serialization- クライアントコンポーネントに渡すデータを最小化するserver-parallel-fetching- コンポーネントを再構築してフェッチを並列化するserver-after-nonblocking- 非ブロッキング操作には after() を使用する
4. クライアントサイドデータフェッチ(MEDIUM-HIGH)
client-swr-dedup- SWR を使用して自動的にリクエストを重複排除するclient-event-listeners- グローバルイベントリスナーを重複排除する
5. 再レンダリングの最適化(MEDIUM)
rerender-defer-reads- コールバック内でのみ使用される状態を購読しないrerender-memo- 高負荷な処理をメモ化されたコンポーネントに抽出するrerender-dependencies- エフェクトの依存関係にはプリミティブ値を使用するrerender-derived-state- 生の値ではなく、派生した真偽値を購読するrerender-functional-setstate- 安定したコールバックのために関数型 setState を使用するrerender-lazy-state-init- 高コストな値には useState に関数を渡すrerender-transitions- 緊急でない更新には startTransition を使用する
6. レンダリングパフォーマンス(MEDIUM)
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 パフォーマンス(LOW-MEDIUM)
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. 高度なパターン(LOW)
advanced-event-handler-refs- イベントハンドラーを ref に格納するadvanced-use-latest- 安定したコールバック参照には useLatest を使用する
使用方法
個別のルールファイルで詳しい説明とコード例を確認できます:
rules/async-parallel.md
rules/bundle-barrel-imports.md
rules/_sections.md
各ルールファイルには以下が含まれます:
- なぜ重要なのかの簡単な説明
- 説明付きの誤ったコード例
- 説明付きの正しいコード例
- 追加のコンテキストと参照
完全版ドキュメント
全ルールを展開した完全ガイドはこちら:AGENTS.md