Melhores Práticas React da Vercel
Guia abrangente de otimização de desempenho para aplicações React e Next.js, mantido pela Vercel. Contém 45 regras em 8 categorias, priorizadas por impacto para orientar refatoração automatizada e geração de código.
Quando Aplicar
Consulte estas diretrizes quando:
- Escrevendo novos componentes React ou páginas Next.js
- Implementando busca de dados (no cliente ou no servidor)
- Revisando código em busca de problemas de desempenho
- Refatorando código React/Next.js existente
- Otimizando tamanho do bundle ou tempos de carregamento
Categorias de Regras por Prioridade
| Prioridade | Categoria | Impacto | Prefixo |
|---|---|---|---|
| 1 | Eliminando Waterfalls | CRÍTICO | async- |
| 2 | Otimização de Tamanho do Bundle | CRÍTICO | bundle- |
| 3 | Desempenho no Servidor | ALTO | server- |
| 4 | Busca de Dados no Cliente | MÉDIO-ALTO | client- |
| 5 | Otimização de Re-renderização | MÉDIO | rerender- |
| 6 | Desempenho de Renderização | MÉDIO | rendering- |
| 7 | Desempenho JavaScript | BAIXO-MÉDIO | js- |
| 8 | Padrões Avançados | BAIXO | advanced- |
Referência Rápida
1. Eliminando Waterfalls (CRÍTICO)
async-defer-await- Mova await para branches onde é realmente usadoasync-parallel- Use Promise.all() para operações independentesasync-dependencies- Use better-all para dependências parciaisasync-api-routes- Inicie promises cedo, espere tarde em rotas de APIasync-suspense-boundaries- Use Suspense para fazer streaming de conteúdo
2. Otimização de Tamanho do Bundle (CRÍTICO)
bundle-barrel-imports- Importe diretamente, evite arquivos barrelbundle-dynamic-imports- Use next/dynamic para componentes pesadosbundle-defer-third-party- Carregue analytics/logging após a hidrataçãobundle-conditional- Carregue módulos apenas quando a funcionalidade estiver ativadabundle-preload- Pré-carregue ao passar o mouse/foco para velocidade percebida
3. Desempenho no Servidor (ALTO)
server-cache-react- Use React.cache() para desduplicação por requisiçãoserver-cache-lru- Use cache LRU para cache entre requisiçõesserver-serialization- Minimize dados passados para componentes clienteserver-parallel-fetching- Reestruture componentes para paralelizar buscasserver-after-nonblocking- Use after() para operações não bloqueantes
4. Busca de Dados no Cliente (MÉDIO-ALTO)
client-swr-dedup- Use SWR para desduplicação automática de requisiçõesclient-event-listeners- Desduplique listeners de eventos globais
5. Otimização de Re-renderização (MÉDIO)
rerender-defer-reads- Não se inscreva em estado usado apenas em callbacksrerender-memo- Extraia trabalho caro em componentes memoizadosrerender-dependencies- Use dependências primitivas em effectsrerender-derived-state- Inscreva-se em booleanos derivados, não em valores brutosrerender-functional-setstate- Use setState funcional para callbacks estáveisrerender-lazy-state-init- Passe função para useState para valores carosrerender-transitions- Use startTransition para atualizações não urgentes
6. Desempenho de Renderização (MÉDIO)
rendering-animate-svg-wrapper- Anime o wrapper div, não o elemento SVGrendering-content-visibility- Use content-visibility para listas longasrendering-hoist-jsx- Extraia JSX estático para fora dos componentesrendering-svg-precision- Reduza a precisão das coordenadas SVGrendering-hydration-no-flicker- Use script inline para dados apenas do clienterendering-activity- Use o componente Activity para mostrar/esconderrendering-conditional-render- Use ternário, não && para condicionais
7. Desempenho JavaScript (BAIXO-MÉDIO)
js-batch-dom-css- Agrupe mudanças de CSS via classes ou cssTextjs-index-maps- Construa Map para buscas repetidasjs-cache-property-access- Armazene em cache propriedades de objetos em loopsjs-cache-function-results- Armazene em cache resultados de funções em Map no nível do módulojs-cache-storage- Armazene em cache leituras de localStorage/sessionStoragejs-combine-iterations- Combine múltiplos filter/map em um único loopjs-length-check-first- Verifique o comprimento do array antes de comparação carajs-early-exit- Retorne cedo de funçõesjs-hoist-regexp- Eleve a criação de RegExp para fora dos loopsjs-min-max-loop- Use loop para min/max em vez de sortjs-set-map-lookups- Use Set/Map para buscas O(1)js-tosorted-immutable- Use toSorted() para imutabilidade
8. Padrões Avançados (BAIXO)
advanced-event-handler-refs- Armazene handlers de eventos em refsadvanced-use-latest- useLatest para refs de callback estáveis
Como Usar
Leia os arquivos de regras individuais para explicações detalhadas e exemplos de código:
rules/async-parallel.md
rules/bundle-barrel-imports.md
rules/_sections.md
Cada arquivo de regra contém:
- Breve explicação de por que é importante
- Exemplo de código incorreto com explicação
- Exemplo de código correto com explicação
- Contexto adicional e referências
Documento Compilado Completo
Para o guia completo com todas as regras expandidas: AGENTS.md