Prácticas Recomendadas de React de Vercel
Guía comprensiva de optimización de rendimiento para aplicaciones React y Next.js, mantenida por Vercel. Contiene 45 reglas en 8 categorías, priorizadas por impacto para guiar la refactorización automatizada y la generación de código.
Cuándo Aplicar
Consulte estas pautas cuando:
- Escriba nuevos componentes React o páginas Next.js
- Implemente obtención de datos (del lado del cliente o del servidor)
- Revise código en busca de problemas de rendimiento
- Refactorice código React/Next.js existente
- Optimice el tamaño del bundle o los tiempos de carga
Categorías de Reglas por Prioridad
| Prioridad | Categoría | Impacto | Prefijo |
|---|---|---|---|
| 1 | Eliminación de Cascadas | CRÍTICO | async- |
| 2 | Optimización del Tamaño del Bundle | CRÍTICO | bundle- |
| 3 | Rendimiento del Lado del Servidor | ALTO | server- |
| 4 | Obtención de Datos del Lado del Cliente | MEDIO-ALTO | client- |
| 5 | Optimización de Re-renderizados | MEDIO | rerender- |
| 6 | Rendimiento de Renderizado | MEDIO | rendering- |
| 7 | Rendimiento de JavaScript | BAJO-MEDIO | js- |
| 8 | Patrones Avanzados | BAJO | advanced- |
Referencia Rápida
1. Eliminación de Cascadas (CRÍTICO)
async-defer-await- Mueva await a las ramas donde realmente se usaasync-parallel- Use Promise.all() para operaciones independientesasync-dependencies- Use better-all para dependencias parcialesasync-api-routes- Inicie promesas temprano, espere tarde en rutas APIasync-suspense-boundaries- Use Suspense para transmitir contenido
2. Optimización del Tamaño del Bundle (CRÍTICO)
bundle-barrel-imports- Importe directamente, evite archivos barrelbundle-dynamic-imports- Use next/dynamic para componentes pesadosbundle-defer-third-party- Cargue análisis/registro después de la hidrataciónbundle-conditional- Cargue módulos solo cuando la característica esté activadabundle-preload- Precargue al pasar el ratón/enfoque para velocidad percibida
3. Rendimiento del Lado del Servidor (ALTO)
server-cache-react- Use React.cache() para deduplicación por solicitudserver-cache-lru- Use caché LRU para almacenamiento en caché entre solicitudesserver-serialization- Minimice los datos pasados a componentes del clienteserver-parallel-fetching- Reestructure componentes para paralelizar búsquedasserver-after-nonblocking- Use after() para operaciones no bloqueantes
4. Obtención de Datos del Lado del Cliente (MEDIO-ALTO)
client-swr-dedup- Use SWR para deduplicación automática de solicitudesclient-event-listeners- Deduplique oyentes de eventos globales
5. Optimización de Re-renderizados (MEDIO)
rerender-defer-reads- No se suscriba a estado que solo se usa en callbacksrerender-memo- Extraiga trabajo costoso en componentes memoizadosrerender-dependencies- Use dependencias primitivas en efectosrerender-derived-state- Suscríbase a booleanos derivados, no a valores brutosrerender-functional-setstate- Use setState funcional para callbacks establesrerender-lazy-state-init- Pase función a useState para valores costososrerender-transitions- Use startTransition para actualizaciones no urgentes
6. Rendimiento de Renderizado (MEDIO)
rendering-animate-svg-wrapper- Anime el contenedor div, no el elemento SVGrendering-content-visibility- Use content-visibility para listas largasrendering-hoist-jsx- Extraiga JSX estático fuera de los componentesrendering-svg-precision- Reduzca la precisión de coordenadas SVGrendering-hydration-no-flicker- Use script en línea para datos solo del clienterendering-activity- Use el componente Activity para mostrar/ocultarrendering-conditional-render- Use ternario, no && para condicionales
7. Rendimiento de JavaScript (BAJO-MEDIO)
js-batch-dom-css- Agrupe cambios CSS mediante clases o cssTextjs-index-maps- Construya Map para búsquedas repetidasjs-cache-property-access- Almacene en caché propiedades de objetos en buclesjs-cache-function-results- Almacene en caché resultados de funciones en Map a nivel de módulojs-cache-storage- Almacene en caché lecturas de localStorage/sessionStoragejs-combine-iterations- Combine múltiples filter/map en un solo buclejs-length-check-first- Verifique la longitud del array antes de una comparación costosajs-early-exit- Retorne temprano de funcionesjs-hoist-regexp- Eleve la creación de RegExp fuera de buclesjs-min-max-loop- Use un bucle para min/max en lugar de sortjs-set-map-lookups- Use Set/Map para búsquedas O(1)js-tosorted-immutable- Use toSorted() para inmutabilidad
8. Patrones Avanzados (BAJO)
advanced-event-handler-refs- Almacene manejadores de eventos en refsadvanced-use-latest- useLatest para refs de callback estables
Cómo Usar
Lea archivos de reglas individuales para explicaciones detalladas y ejemplos de código:
reglas/async-parallel.md
reglas/bundle-barrel-imports.md
reglas/_sections.md
Cada archivo de regla contiene:
- Breve explicación de por qué es importante
- Ejemplo de código incorrecto con explicación
- Ejemplo de código correcto con explicación
- Contexto adicional y referencias
Documento Compilado Completo
Para la guía completa con todas las reglas desarrolladas: AGENTS.md