Next.js e Turbopack
Next.js 16+ usa Turbopack por padrão no desenvolvimento local: um bundler incremental escrito em Rust que acelera significativamente a inicialização do desenvolvimento e a substituição de módulos a quente.
Quando usar
- Turbopack (modo de desenvolvimento padrão): para desenvolvimento diário. Inicialização a frio e substituição de módulos a quente mais rápidas, especialmente em aplicações grandes.
- Webpack (modo de desenvolvimento legado): use apenas se encontrar erros do Turbopack ou depender de plugins webpack disponíveis apenas no desenvolvimento. Desative com
--webpack(ou--no-turbopack, dependendo da sua versão do Next.js; consulte a documentação da sua versão). - Produção: o build de produção (
next build) pode usar Turbopack ou webpack, a depender da versão do Next.js; consulte a documentação oficial da sua versão.
Cenário de uso: desenvolver ou depurar aplicações Next.js 16+, diagnosticar inicializações lentas ou HMR lento, ou otimizar bundles de produção.
Como funciona
- Turbopack: bundler incremental para desenvolvimento Next.js. Usa cache de sistema de arquivos, portanto reinicializações são muito mais rápidas (por exemplo, 5–14x mais rápido em projetos grandes).
- Habilitado por padrão no desenvolvimento: a partir do Next.js 16,
next devusa Turbopack por padrão, a menos que seja desabilitado. - Cache de sistema de arquivos: reutiliza trabalho anterior em reinicializações; o cache normalmente fica em
.next; nenhuma configuração extra é necessária para uso básico. - Analisador de bundle (Next.js 16.1+): analisador experimental de bundle para inspecionar a saída e encontrar dependências pesadas; pode ser habilitado via configuração ou flag experimental (consulte a documentação do Next.js da sua versão).
Exemplo
Comandos
next dev
next build
next start
Uso
Execute next dev para usar Turbopack no desenvolvimento local. Use o analisador de bundle (consulte a documentação do Next.js) para otimizar code splitting e remover dependências grandes. Prefira o App Router e componentes de servidor sempre que possível.
Práticas recomendadas
- Mantenha-se em versões recentes do Next.js 16.x para comportamento estável do Turbopack e do cache.
- Se o desenvolvimento estiver lento, certifique-se de que você está usando Turbopack (padrão) e que o cache não está sendo limpo desnecessariamente.
- Para problemas de tamanho de bundle em produção, use a ferramenta oficial de análise de bundle do Next.js da sua versão.