Vercel React Best Practices
Umfassender Leitfaden zur Leistungsoptimierung für React- und Next.js-Anwendungen, bereitgestellt von Vercel. Enthält 70 Regeln in 8 Kategorien, priorisiert nach Auswirkung, um automatisiertes Refactoring und Code-Generierung zu leiten.
Wann anwenden
Diese Richtlinien sollten herangezogen werden bei:
- Schreiben neuer React-Komponenten oder Next.js-Seiten
- Implementieren von Datenabruf (client- oder serverseitig)
- Überprüfen von Code auf Leistungsprobleme
- Refactoring bestehender React/Next.js-Anwendungen
- Optimieren der Bundle-Größe oder Ladezeiten
Regelkategorien nach Priorität
| Priorität | Kategorie | Auswirkung | Präfix |
|---|---|---|---|
| 1 | Wasserfälle beseitigen | KRITISCH | async- |
| 2 | Bundle-Größenoptimierung | KRITISCH | bundle- |
| 3 | Serverseitige Leistung | HOCH | server- |
| 4 | Clientseitiger Datenabruf | MITTEL-HOCH | client- |
| 5 | Re-Render-Optimierung | MITTEL | rerender- |
| 6 | Rendering-Leistung | MITTEL | rendering- |
| 7 | JavaScript-Leistung | NIEDRIG-MITTEL | js- |
| 8 | Fortgeschrittene Muster | NIEDRIG | advanced- |
Kurzreferenz
1. Wasserfälle beseitigen (KRITISCH)
async-cheap-condition-before-await– Prüfe günstige synchrone Bedingungen vor dem Warten auf Flags oder Remote-Werteasync-defer-await– Verschiebe await in die Zweige, in denen es tatsächlich verwendet wirdasync-parallel– VerwendePromise.all()für unabhängige Operationenasync-dependencies– Verwendebetter-allfür partielle Abhängigkeitenasync-api-routes– Starte Promises früh, warte spät in API-Routenasync-suspense-boundaries– Verwende Suspense zum Streamen von Inhalten
2. Bundle-Größenoptimierung (KRITISCH)
bundle-barrel-imports– Importiere direkt, vermeide Barrel-Dateienbundle-analyzable-paths– Bevorzuge statisch analysierbare Import- und Dateisystempfade, um breite Bundles und Traces zu vermeidenbundle-dynamic-imports– Verwendenext/dynamicfür schwere Komponentenbundle-defer-third-party– Lade Analytics/Logging nach der Hydrationbundle-conditional– Lade Module nur, wenn die Funktion aktiviert istbundle-preload– Lade bei Hover/Fokus vor, um wahrgenommene Geschwindigkeit zu erhöhen
3. Serverseitige Leistung (HOCH)
server-auth-actions– Authentifiziere Serveraktionen wie API-Routenserver-cache-react– VerwendeReact.cache()für Ent-Duplizierung pro Anfrageserver-cache-lru– Verwende LRU-Cache für Caching über Anfragen hinwegserver-dedup-props– Vermeide doppelte Serialisierung in RSC-Propsserver-hoist-static-io– Hebe statische I/O (Schriftarten, Logos) auf Modulebeneserver-no-shared-module-state– Vermeide veränderlichen Request-Status auf Modulebene in RSC/SSRserver-serialization– Minimiere Daten, die an Client-Komponenten übergeben werdenserver-parallel-fetching– Strukturiere Komponenten um, um Fetch-Vorgänge zu parallelisierenserver-parallel-nested-fetching– Verkette verschachtelte Fetch-Vorgänge pro Element inPromise.allserver-after-nonblocking– Verwendeafter()für nicht blockierende Operationen
4. Clientseitiger Datenabruf (MITTEL-HOCH)
client-swr-dedup– Verwende SWR für automatische Anfrage-Ent-Duplizierungclient-event-listeners– Ent-dupliziere globale Event-Listenerclient-passive-event-listeners– Verwende passive Listener für Scrollenclient-localstorage-schema– Versioniere und minimiere localStorage-Daten
5. Re-Render-Optimierung (MITTEL)
rerender-defer-reads– Abonniere keinen Status, der nur in Callbacks verwendet wirdrerender-memo– Extrahiere teure Arbeit in gememoizierte Komponentenrerender-memo-with-default-value– Hebe Standard-Nicht-Primitiv-Props auf Modulebenererender-dependencies– Verwende primitive Abhängigkeiten in Effektenrerender-derived-state– Abonniere abgeleitete Booleans, nicht Rohwertererender-derived-state-no-effect– Leite Status während des Renderns ab, nicht in Effektenrerender-functional-setstate– Verwende funktionales setState für stabile Callbacksrerender-lazy-state-init– Übergib eine Funktion anuseStatefür teure Wertererender-simple-expression-in-memo– Vermeide memo für einfache Primitivererender-split-combined-hooks– Teile Hooks mit unabhängigen Abhängigkeitenrerender-move-effect-to-event– Lege Interaktionslogik in Event-Handlerrerender-transitions– VerwendestartTransitionfür nicht dringende Updatesrerender-use-deferred-value– Verschiebe teure Renderings, um die Eingabe reaktionsschnell zu haltenrerender-use-ref-transient-values– Verwende Refs für flüchtige, häufige Wertererender-no-inline-components– Definiere keine Komponenten innerhalb von Komponenten
6. Rendering-Leistung (MITTEL)
rendering-animate-svg-wrapper– Animiere den div-Wrapper, nicht das SVG-Elementrendering-content-visibility– Verwendecontent-visibilityfür lange Listenrendering-hoist-jsx– Extrahiere statische JSX-Teile außerhalb von Komponentenrendering-svg-precision– Reduziere die SVG-Koordinatenpräzisionrendering-hydration-no-flicker– Verwende Inline-Skript für clientseitige Datenrendering-hydration-suppress-warning– Unterdrücke erwartete Abweichungenrendering-activity– Verwende die Activity-Komponente für Ein-/Ausblendenrendering-conditional-render– Verwende ternäre Operatoren, nicht&&für Bedingungenrendering-usetransition-loading– BevorzugeuseTransitionfür Ladezuständerendering-resource-hints– Verwende React DOM Resource Hints zum Vorladenrendering-script-defer-async– Verwendedeferoderasyncauf Script-Tags
7. JavaScript-Leistung (NIEDRIG-MITTEL)
js-batch-dom-css– Gruppiere CSS-Änderungen über Klassen oder cssTextjs-index-maps– Erstelle eine Map für wiederholte Lookupsjs-cache-property-access– Cache Objekteigenschaften in Schleifenjs-cache-function-results– Cache Funktionsergebnisse in einer Map auf Modulebenejs-cache-storage– Cache localStorage-/sessionStorage-Zugriffejs-combine-iterations– Kombiniere mehrere filter/map zu einer Schleifejs-length-check-first– Prüfe Array-Länge vor teurem Vergleichjs-early-exit– Breche frühzeitig aus Funktionen ausjs-hoist-regexp– Hebe RegExp-Erstellung außerhalb von Schleifenjs-min-max-loop– Verwende eine Schleife für min/max, nicht sortjs-set-map-lookups– Verwende Set/Map für O(1)-Lookupsjs-tosorted-immutable– VerwendetoSorted()für Unveränderlichkeitjs-flatmap-filter– VerwendeflatMap, um in einem Durchlauf zu mappen und zu filternjs-request-idle-callback– Verschiebe nicht kritische Arbeit in die Leerlaufzeit des Browsers
8. Fortgeschrittene Muster (NIEDRIG)
advanced-effect-event-deps– SetzeuseEffectEvent-Ergebnisse nicht in Effekt-Abhängigkeitenadvanced-event-handler-refs– Speichere Event-Handler in Refsadvanced-init-once– Initialisiere die App einmal pro App-Ladungadvanced-use-latest– VerwendeuseLatestfür stabile Callback-Refs
Wie verwenden
Lies die einzelnen Regeldateien für detaillierte Erklärungen und Codebeispiele:
rules/async-parallel.md
rules/bundle-barrel-imports.md
Jede Regeldatei enthält:
- Kurze Erklärung, warum sie wichtig ist
- Fehlerhaftes Codebeispiel mit Erklärung
- Korrektes Codebeispiel mit Erklärung
- Zusätzlicher Kontext und Referenzen
Vollständiges kompiliertes Dokument
Für den vollständigen Leitfaden mit allen erweiterten Regeln: AGENTS.md