Vercel React Best Practices
Umfassender Leitfaden zur Leistungsoptimierung für React- und Next.js-Anwendungen, gepflegt von Vercel. Enthält 45 Regeln in 8 Kategorien, priorisiert nach Auswirkung, um automatisiertes Refactoring und Codegenerierung zu steuern.
Wann anwenden
Diese Richtlinien sollten herangezogen werden, wenn:
- Neue React-Komponenten oder Next.js-Seiten geschrieben werden
- Datenabrufe (client- oder serverseitig) implementiert werden
- Code auf Leistungsprobleme überprüft wird
- Vorhandener React/Next.js-Code refaktoriert wird
- Die Bundle-Größe oder Ladezeiten optimiert werden
Regelkategorien nach Priorität
| Priorität | Kategorie | Auswirkung | Präfix |
|---|---|---|---|
| 1 | Wasserfälle eliminieren | KRITISCH | async- |
| 2 | Bundle-Größenoptimierung | KRITISCH | bundle- |
| 3 | Server-seitige Leistung | HOCH | server- |
| 4 | Client-seitiger 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 eliminieren (KRITISCH)
async-defer-await- await in Zweige verschieben, wo es tatsächlich verwendet wirdasync-parallel- Promise.all() für unabhängige Operationen verwendenasync-dependencies- better-all für partielle Abhängigkeiten verwendenasync-api-routes- Promises früh starten, spät awaiten in API-Routenasync-suspense-boundaries- Suspense verwenden, um Inhalte zu streamen
2. Bundle-Größenoptimierung (KRITISCH)
bundle-barrel-imports- Direkt importieren, Barrel-Dateien vermeidenbundle-dynamic-imports- next/dynamic für schwere Komponenten verwendenbundle-defer-third-party- Analyse-/Logging-Code nach der Hydration ladenbundle-conditional- Module nur laden, wenn die Funktion aktiviert istbundle-preload- Bei Hover/Fokus vorladen für gefühlte Geschwindigkeit
3. Server-seitige Leistung (HOCH)
server-cache-react- React.cache() für Entdoppelung pro Anfrage verwendenserver-cache-lru- LRU-Cache für Caching über mehrere Anfragen verwendenserver-serialization- Daten minimieren, die an Client-Komponenten übergeben werdenserver-parallel-fetching- Komponenten umstrukturieren, um Abrufe zu parallelisierenserver-after-nonblocking- after() für nicht blockierende Operationen verwenden
4. Client-seitiger Datenabruf (MITTEL-HOCH)
client-swr-dedup- SWR für automatische Entdoppelung von Anfragen verwendenclient-event-listeners- Globale Ereignis-Listener entdoppeln
5. Re-Render-Optimierung (MITTEL)
rerender-defer-reads- Nicht auf Zustand abonnieren, der nur in Callbacks verwendet wirdrerender-memo- Teure Arbeit in gememote Komponenten auslagernrerender-dependencies- Primitive Abhängigkeiten in Effekten verwendenrerender-derived-state- Abgeleitete Booleans abonnieren, nicht Rohwertererender-functional-setstate- Funktionale setState für stabile Callbacks verwendenrerender-lazy-state-init- Funktion an useState übergeben für teure Wertererender-transitions- startTransition für nicht dringende Aktualisierungen verwenden
6. Rendering-Leistung (MITTEL)
rendering-animate-svg-wrapper- Div-Wrapper animieren, nicht das SVG-Elementrendering-content-visibility- content-visibility für lange Listen verwendenrendering-hoist-jsx- Statisches JSX außerhalb von Komponenten extrahierenrendering-svg-precision- SVG-Koordinatenpräzision reduzierenrendering-hydration-no-flicker- Inline-Skript für clientseitige Daten verwendenrendering-activity- Activity-Komponente für Ein-/Ausblenden verwendenrendering-conditional-render- Ternären Operator verwenden, nicht && für Bedingungen
7. JavaScript-Leistung (NIEDRIG-MITTEL)
js-batch-dom-css- CSS-Änderungen über Klassen oder cssText gruppierenjs-index-maps- Map für wiederholte Nachschlagen aufbauenjs-cache-property-access- Objekteigenschaften in Schleifen cachenjs-cache-function-results- Funktionsergebnisse in modulweiter Map cachenjs-cache-storage- localStorage/sessionStorage-Lesezugriffe cachenjs-combine-iterations- Mehrere filter/map in einer Schleife kombinierenjs-length-check-first- Array-Länge vor teurem Vergleich prüfenjs-early-exit- Frühzeitig aus Funktionen zurückkehrenjs-hoist-regexp- RegExp-Erstellung außerhalb von Schleifen platzierenjs-min-max-loop- Schleife für Min/Max anstelle von sort verwendenjs-set-map-lookups- Set/Map für O(1)-Nachschlagen verwendenjs-tosorted-immutable- toSorted() für Unveränderlichkeit verwenden
8. Fortgeschrittene Muster (NIEDRIG)
advanced-event-handler-refs- Ereignis-Handler in Refs speichernadvanced-use-latest- useLatest für stabile Callback-Refs
Verwendung
Die einzelnen Regeldateien enthalten detaillierte Erklärungen und Codebeispiele:
rules/async-parallel.md
rules/bundle-barrel-imports.md
rules/_sections.md
Jede Regeldatei enthält:
- Kurze Erklärung, warum sie wichtig ist
- Falsches Codebeispiel mit Erklärung
- Korrektes Codebeispiel mit Erklärung
- Zusätzlicher Kontext und Verweise
Vollständiges kompiliertes Dokument
Für die vollständige Anleitung mit allen erweiterten Regeln: AGENTS.md