Vercel React ベストプラクティス
React および Next.js アプリケーション向けの包括的なパフォーマンス最適化ガイド。Vercel が管理しています。8 カテゴリにまたがる 70 のルールが優先度順に整理されており、自動リファクタリングやコード生成を支援します。
適用タイミング
以下のケースでこれらのガイドラインを参照してください:
- 新しい 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-cheap-condition-before-await- await する前に安価な同期条件をチェックするasync-defer-await- await を実際に使用する分岐に移動するasync-parallel- 独立した処理には Promise.all() を使用するasync-dependencies- 部分的な依存関係には better-all を使用するasync-api-routes- API ルートではプロミスを早期に開始し、遅れて await するasync-suspense-boundaries- Suspense を使用してコンテンツをストリーミングする
2. バンドルサイズの最適化(重大)
bundle-barrel-imports- バレルファイルを避け、直接インポートするbundle-analyzable-paths- 静的に解析可能なインポートパスとファイルシステムパスを優先し、広範なバンドルやトレースを避けるbundle-dynamic-imports- 重いコンポーネントには next/dynamic を使用するbundle-defer-third-party- アナリティクス/ログはハイドレーション後に読み込むbundle-conditional- 機能が有効な場合のみモジュールを読み込むbundle-preload- ホバー/フォーカス時にプリロードして体感速度を向上させる
3. サーバーサイドのパフォーマンス(高)
server-auth-actions- サーバーアクションを API ルートと同様に認証するserver-cache-react- React.cache() を使用してリクエストごとの重複排除を行うserver-cache-lru- LRU キャッシュを使用してリクエスト間キャッシュを行うserver-dedup-props- RSC プロパティの重複シリアライズを避けるserver-hoist-static-io- 静的な I/O(フォント、ロゴ)をモジュールレベルに引き上げるserver-no-shared-module-state- RSC/SSR でモジュールレベルの可変リクエスト状態を避けるserver-serialization- クライアントコンポーネントに渡すデータを最小化するserver-parallel-fetching- フェッチを並列化するようにコンポーネントを再構成するserver-parallel-nested-fetching- ネストされたフェッチを Promise.all 内でアイテムごとに連鎖させるserver-after-nonblocking- 非ブロッキング処理には after() を使用する
4. クライアントサイドデータフェッチ(中-高)
client-swr-dedup- SWR を使用して自動リクエスト重複排除を行うclient-event-listeners- グローバルイベントリスナーを重複排除するclient-passive-event-listeners- スクロールにはパッシブリスナーを使用するclient-localstorage-schema- localStorage データにバージョン管理と最小化を適用する
5. 再レンダリングの最適化(中)
rerender-defer-reads- コールバックでしか使わない state にサブスクライブしないrerender-memo- 重い処理をメモ化されたコンポーネントに抽出するrerender-memo-with-default-value- デフォルトの非プリミティブプロップを引き上げるrerender-dependencies- エフェクトではプリミティブな依存関係を使用するrerender-derived-state- 生の値ではなく、派生した真偽値にサブスクライブするrerender-derived-state-no-effect- エフェクトではなくレンダリング中に state を導出するrerender-functional-setstate- 安定したコールバックには関数型 setState を使用するrerender-lazy-state-init- 重い値には関数を useState に渡すrerender-simple-expression-in-memo- 単純なプリミティブには memo を避けるrerender-split-combined-hooks- 独立した依存関係を持つフックを分割するrerender-move-effect-to-event- インタラクションロジックをイベントハンドラに移すrerender-transitions- 緊急でない更新には startTransition を使用するrerender-use-deferred-value- 重いレンダリングを遅延させ、入力の応答性を維持するrerender-use-ref-transient-values- 頻繁に変わる一時的な値には ref を使用するrerender-no-inline-components- コンポーネントの中にコンポーネントを定義しない
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-hydration-suppress-warning- 予想される不一致を抑制するrendering-activity- 表示/非表示には Activity コンポーネントを使用するrendering-conditional-render- 条件分岐には && ではなく三項演算子を使用するrendering-usetransition-loading- ローディング状態には useTransition を優先するrendering-resource-hints- プリロードに React DOM のリソースヒントを使用するrendering-script-defer-async- script タグには defer または async を使用する
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() を使用するjs-flatmap-filter- flatMap でマップとフィルタを 1 パスで行うjs-request-idle-callback- 重要でない処理をブラウザのアイドル時間に延期する
8. 高度なパターン(低)
advanced-effect-event-deps-useEffectEventの結果をエフェクトの依存関係に入れないadvanced-event-handler-refs- イベントハンドラを ref に保存するadvanced-init-once- アプリ読み込みごとに 1 回だけ初期化するadvanced-use-latest- 安定したコールバック ref には useLatest を使用する
使い方
個別のルールファイルで詳細な説明とコード例を確認してください:
rules/async-parallel.md
rules/bundle-barrel-imports.md
各ルールファイルには以下が含まれます:
- そのルールが重要な理由の簡単な説明
- 間違ったコード例とその説明
- 正しいコード例とその説明
- 追加のコンテキストと参考情報
完全なコンパイル済みドキュメント
すべてのルールを展開した完全ガイドはこちら:AGENTS.md