TypeScript Academy · Aula

Reexportações e arquivos de agregação

Crie arquivos de índice para simplificar os caminhos de importação

Aula 2 de 413 etapas

Reexportações e arquivos de agregação é uma aula grátis de TypeScript Academy no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de TypeScript Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de TypeScript Academy inclui 4 aulas no total.

Boas-vindas

Os arquivos agregadores (index.ts) reúnem e reexportam o conteúdo dos módulos, criando uma API pública simples para um diretório e permitindo caminhos de importação mais organizados para quem os utiliza.

O que é um arquivo agregador

Um arquivo agregador é um index.ts que reexporta tudo do mesmo diretório. Quem utiliza os módulos importa do diretório em vez de arquivos individuais.

// src/models/index.ts (barrel)
export { User } from './user';
export { Product } from './product';
export { Order } from './order';

Usando o arquivo agregador

Importe do arquivo agregador em vez de arquivos individuais para obter caminhos mais organizados.

// Before barrel:
import { User } from '../models/user';
import { Product } from '../models/product';

// After barrel:
import { User, Product } from '../models';

Reexportação curinga com export *

Reexporte todas as exportações nomeadas de um módulo com `export *`.

// index.ts
export * from './utils';
export * from './helpers';
export * from './validators';

Renomeando durante a reexportação

Você pode renomear as exportações ao reexportá-las.

export { default as MyButton } from './Button';
export { Button as Btn } from './Button';

Reexportações somente de tipo

Reexporte tipos sem impacto no código de execução.

export type { User, UserRole } from './user.types';

Arquivo agregador para um módulo de funcionalidade

As pastas de funcionalidades em aplicativos grandes geralmente têm um arquivo agregador que expõe apenas a superfície pública.

// features/auth/index.ts
export { AuthProvider } from './AuthProvider';
export { useAuth } from './useAuth';
export type { AuthUser } from './types';

Risco de dependência circular

Os arquivos agregadores podem introduzir dependências circulares se os arquivos do mesmo agregador importarem uns dos outros indiretamente por meio do índice. Tenha atenção a isso.

Eliminação de código não utilizado e arquivos agregadores

Os empacotadores modernos (Webpack, Rollup, Vite) eliminam as reexportações não utilizadas dos arquivos agregadores. Somente as exportações realmente usadas são incluídas no pacote.

Arquivos agregadores profundos e superficiais

Aninhe arquivos agregadores: cada subdiretório tem seu próprio index.ts, e o arquivo agregador pai reexporta os arquivos agregadores dos subdiretórios.

// src/index.ts
export * from './models';
export * from './services';
export * from './utils';

Arquivos agregadores e desempenho do TypeScript

Arquivos agregadores profundamente aninhados podem tornar a compilação do TypeScript mais lenta. Em projetos grandes, considere simplificar a estrutura ou usar aliases de caminhos.

Verificação rápida

Qual é o principal benefício de usar um arquivo agregador (index.ts)?

Responda na aula interativa

Recapitulação

Os arquivos agregadores (index.ts) reexportam conteúdo de um diretório, criando caminhos de importação organizados. Use `export *` para reexportações em massa, `export type` somente para tipos e tenha atenção aos riscos de dependências circulares em projetos grandes.

Grátis para começar

Aprenda TypeScript com um tutor de IA — grátis

Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.

Cursos: 101
Aulas: 352

Começar a aprender grátis Ver o curso completo

Perguntas Frequentes

A aula “Reexportações e arquivos de agregação” é grátis?

Sim — o texto completo de “Reexportações e arquivos de agregação” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de TypeScript Academy, atualize para CoddyKit PRO. O curso de TypeScript Academy inclui 4 aulas no total.

O que vou aprender em “Reexportações e arquivos de agregação”?

Crie arquivos de índice para simplificar os caminhos de importação Você pratica TypeScript Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar TypeScript Academy?

Nenhuma experiência prévia é necessária. TypeScript Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.

Quanto tempo leva a aula “Reexportações e arquivos de agregação”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de TypeScript Academy?

Sim. Cada aula de TypeScript Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

Sintaxe de módulos ES: import e export
Reexportações e arquivos de agregação
Importações e exportações somente de tipos
Namespaces versus módulos: uso moderno

← Voltar para TypeScript Academy