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 automatisierte Refaktorierung und Codegenerierung zu leiten.
Wann anwenden
Beziehen Sie sich auf diese Richtlinien, wenn:
- Neue React-Komponenten oder Next.js-Seiten geschrieben werden
- Datenabruf (client- oder serverseitig) implementiert wird
- Code auf Leistungsprobleme überprüft wird
- Vorhandener React/Next.js-Code refaktoriert wird
- Bundle-Größe oder Ladezeiten optimiert werden
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 | Neurender-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-defer-await– await in die Zweige verschieben, in denen es tatsächlich verwendet wirdasync-parallel– Promise.all() für unabhängige Operationen verwendenasync-dependencies– better-all für partielle Abhängigkeiten nutzenasync-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– Analytics/Logging nach der Hydration ladenbundle-conditional– Module nur laden, wenn die Funktion aktiviert istbundle-preload– Beim Hover/Fokus vorladen für gefühlte Geschwindigkeit
3. Serverseitige Leistung (HOCH)
server-cache-react– React.cache() für pro-Request-Deduplizierung verwendenserver-cache-lru– LRU-Cache für Cross-Request-Caching verwendenserver-serialization– An Client-Komponenten übergebene Daten minimierenserver-parallel-fetching– Komponenten umstrukturieren, um Abrufe zu parallelisierenserver-after-nonblocking– after() für nicht blockierende Operationen verwenden
4. Clientseitiger Datenabruf (MITTEL-HOCH)
client-swr-dedup– SWR für automatische Request-Deduplizierung verwendenclient-event-listeners– Globale Event-Listener deduplizieren
5. Neurender-Optimierung (MITTEL)
rerender-defer-reads– Keinen State abonnieren, der nur in Callbacks verwendet wirdrerender-memo– Teure Arbeit in memorierte Komponenten auslagernrerender-dependencies– Primitive Abhängigkeiten in Effekten verwendenrerender-derived-state– Abgeleitete Booleans abonnieren, nicht Rohwertererender-functional-setstate– Funktionelles setState für stabile Callbacks verwendenrerender-lazy-state-init– Funktion an useState für teure Werte übergebenrerender-transitions– startTransition für nicht dringende Updates 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-Koordinatengenauigkeit reduzierenrendering-hydration-no-flicker– Inline-Skript für clientseitige Daten verwendenrendering-activity– Activity-Komponente für Ein-/Ausblenden verwendenrendering-conditional-render– Ternär 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 Lookups erstellenjs-cache-property-access– Objekteigenschaften in Schleifen cachenjs-cache-function-results– Funktionsergebnisse in modulweiter Map cachenjs-cache-storage– localStorage/sessionStorage-Lesevorgänge 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 aus Schleifen herausziehenjs-min-max-loop– Schleife für min/max statt sort verwendenjs-set-map-lookups– Set/Map für O(1)-Lookups verwendenjs-tosorted-immutable– toSorted() für Unveränderlichkeit verwenden
8. Fortgeschrittene Muster (NIEDRIG)
advanced-event-handler-refs– Event-Handler in Refs speichernadvanced-use-latest– useLatest für stabile Callback-Refs
Verwendung
Lesen Sie die einzelnen Regeldateien für 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
- Richtiges Codebeispiel mit Erklärung
- Zusätzlicher Kontext und Referenzen
Vollständiges kompiliertes Dokument
Für die vollständige Anleitung mit allen erweiterten Regeln: AGENTS.md