Referências de projetos (introdução)
Divida o código em vários projetos tsconfig e faça referência a eles para obter compilações incrementais mais rápidas.
Referências de projetos (introdução) é uma aula grátis de TypeScript Academy no CoddyKit. Esta é a aula 3 de 3. 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 3 aulas no total.
Introdução
Objetivo: aprenda sobre as Referências de projeto. Elas conectam vários projetos tsconfig para melhorar a velocidade e a organização da compilação.
Configuração raiz
Na raiz, adicione uma matriz references. Cada caminho aponta para a pasta de outro projeto tsconfig.
// tsconfig.json (root)
{
"files": [],
"references": [
{ "path": "./core" },
{ "path": "./web" }
]
}Projeto composto
Cada projeto referenciado deve ativar composite. Isso permite que o TypeScript gere metadados para acompanhar dependências.
// core/tsconfig.json
{
"compilerOptions": {
"composite": true,
"outDir": "../dist/core"
},
"include": ["src"]
}Referenciar outro projeto
O projeto web referencia core. O tsc compilará primeiro o core e depois o web, reutilizando as saídas.
// web/tsconfig.json
{
"compilerOptions": {
"composite": true,
"outDir": "../dist/web"
},
"references": [
{ "path": "../core" }
]
}Comando de compilação
Use tsc --build (ou -b) para compilar todos os projetos referenciados. As compilações incrementais são muito mais rápidas.
// Build all projects
npx tsc --build
// Incremental rebuild when only core changes
npx tsc --build coreSuporte do ambiente de desenvolvimento
O VS Code entende as Referências de projeto: permite navegar entre projetos, exibe erros de forma consistente e reutiliza as saídas de declarações.
Verificação dos benefícios
Verificação rápida: qual é o principal benefício das Referências de projeto?
Recapitulação
Recapitulação: as Referências de projeto dividem o código em subprojetos com configurações composite. Elas melhoram a velocidade de compilação e a organização em repositórios grandes.
Perguntas Frequentes
A aula “Referências de projetos (introdução)” é grátis?
Sim — o texto completo de “Referências de projetos (introduçã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 3 aulas no total.
O que vou aprender em “Referências de projetos (introdução)”?
Divida o código em vários projetos tsconfig e faça referência a eles para obter compilações incrementais mais rápidas. 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 3 de 3.
Quanto tempo leva a aula “Referências de projetos (introduçã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
- Opções de rigor
- Configurações de target, lib, module e JSX
- Referências de projetos (introdução)