Mejores Prácticas de React de Vercel
Guía completa de optimización de rendimiento para aplicaciones React y Next.js, mantenida por Vercel. Contiene 70 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 paquete 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 Paquete | 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-cheap-condition-before-await- Verifique condiciones sincrónicas baratas antes de esperar banderas o valores remotosasync-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 las promesas temprano, espere tarde en rutas APIasync-suspense-boundaries- Use Suspense para transmitir contenido
2. Optimización del Tamaño del Paquete (CRÍTICO)
bundle-barrel-imports- Importe directamente, evite archivos barrelbundle-analyzable-paths- Prefiera rutas de importación y archivos estáticamente analizables para evitar paquetes y trazas ampliasbundle-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/enfocar para velocidad percibida
3. Rendimiento del Lado del Servidor (ALTO)
server-auth-actions- Autentique acciones del servidor como rutas APIserver-cache-react- Use React.cache() para deduplicación por solicitudserver-cache-lru- Use caché LRU para almacenamiento en caché entre solicitudesserver-dedup-props- Evite serialización duplicada en props RSCserver-hoist-static-io- Eleve E/S estática (fuentes, logotipos) al nivel del móduloserver-no-shared-module-state- Evite estado de solicitud mutable a nivel de módulo en RSC/SSRserver-serialization- Minimice los datos pasados a componentes del clienteserver-parallel-fetching- Reestructure componentes para paralelizar las obtencionesserver-parallel-nested-fetching- Encadene obtenciones anidadas por elemento en Promise.allserver-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- Deduplicar listeners de eventos globalesclient-passive-event-listeners- Use listeners pasivos para scrollclient-localstorage-schema- Versione y minimice los datos de localStorage
5. Optimización de Re-renderizados (MEDIO)
rerender-defer-reads- No se suscriba a estado usado solo en callbacksrerender-memo- Extraiga trabajo costoso en componentes memoizadosrerender-memo-with-default-value- Eleve props no primitivas por defectorerender-dependencies- Use dependencias primitivas en efectosrerender-derived-state- Suscríbase a booleanos derivados, no a valores brutosrerender-derived-state-no-effect- Derive estado durante el renderizado, no en efectosrerender-functional-setstate- Use setState funcional para callbacks establesrerender-lazy-state-init- Pase función a useState para valores costososrerender-simple-expression-in-memo- Evite memo para primitivos simplesrerender-split-combined-hooks- Divida hooks con dependencias independientesrerender-move-effect-to-event- Ponga la lógica de interacción en manejadores de eventosrerender-transitions- Use startTransition para actualizaciones no urgentesrerender-use-deferred-value- Difiera renderizados costosos para mantener la entrada receptivarerender-use-ref-transient-values- Use refs para valores transitorios frecuentesrerender-no-inline-components- No defina componentes dentro de componentes
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-hydration-suppress-warning- Suprima diferencias esperadasrendering-activity- Use el componente Activity para mostrar/ocultarrendering-conditional-render- Use operador ternario, no && para condicionalesrendering-usetransition-loading- Prefiera useTransition para estado de cargarendering-resource-hints- Use sugerencias de recursos de React DOM para precargarendering-script-defer-async- Use defer o async en etiquetas script
7. Rendimiento de JavaScript (BAJO-MEDIO)
js-batch-dom-css- Agrupe cambios de 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 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 inmutabilidadjs-flatmap-filter- Use flatMap para mapear y filtrar en un solo pasojs-request-idle-callback- Difiera trabajo no crítico al tiempo de inactividad del navegador
8. Patrones Avanzados (BAJO)
advanced-effect-event-deps- No ponga resultados deuseEffectEventen dependencias de efectoadvanced-event-handler-refs- Almacene manejadores de eventos en refsadvanced-init-once- Inicialice la aplicación una vez por cargaadvanced-use-latest- useLatest para referencias 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
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 expandidas: AGENTS.md