tsconfig.json: Build:No inputs were found in config file — como corrigir

Introdução: Por que o TypeScript não vê meus arquivos?

Você abre um projeto em TypeScript, inicia a compilação e, de repente — bum! — um balde de água fria na forma da mensagem: tsconfig.json: Build:No inputs were found in config file. Familiar? Se você já lidou com a configuração do TypeScript, provavelmente já viu esse erro. Ele assusta iniciantes e irrita profissionais. Mas não se desespere nem amaldiçoe a Microsoft.

Neste artigo, não vamos apenas mostrar como silenciar o erro rapidamente. Vamos analisar sua anatomia: por que ele ocorre, quais cenários o causam e como configurar o tsconfig.json para que você nunca mais veja essa mensagem. Isso será útil tanto para quem está começando a estudar TypeScript quanto para quem deseja entender mais profundamente a mecânica do compilador.

E sim, falaremos em português, de forma clara e com exemplos. Vamos lá!

O que significa o erro "Build:No inputs were found in config file"?

Traduzindo da linguagem do compilador para o português, o TypeScript está dizendo: "Não sei quais arquivos compilar. Você me pediu para construir o projeto, mas não especificou onde estão os arquivos fonte." O compilador tsc procura arquivos .ts e .tsx, mas não encontra nenhum nos diretórios que você (ou ele mesmo) especificou.

O erro ocorre em duas situações típicas:

\n
• Você acabou de criar um tsconfig.json em uma pasta vazia.
\n
• Você configurou incorretamente os campos include, exclude ou rootDir.
\n

Vamos analisar cada causa detalhadamente para que você não apenas copie a solução, mas entenda por que ela funciona.

Causa nº 1: Não há arquivos TypeScript no projeto

A causa mais banal, porém comum. Você criou um tsconfig.json em uma pasta que não contém nenhum arquivo .ts. O compilador procura honestamente — e não encontra nada.

Exemplo do problema:

meu-projeto/\n├── tsconfig.json\n└── (nada mais)

Ao executar npx tsc — obtém-se o erro. A solução é óbvia: crie pelo menos um arquivo index.ts.

Como corrigir:

meu-projeto/\n├── tsconfig.json\n├── src/\n│   └── index.ts   # <-- Aqui está ele, o salvador!

Mas e se os arquivos existirem e o erro ainda aparecer? Então vamos mais fundo.

Causa nº 2: Caminho incorreto no campo include

O campo include no tsconfig.json diz ao compilador: "Procure arquivos aqui". Se você especificou uma pasta inexistente ou errou o caminho, o compilador não encontrará nada.

Configuração incorreta:

{\n  "compilerOptions": {\n    "target": "ES2020",\n    "module": "commonjs",\n    "outDir": "./dist"\n  },\n  "include": ["src/**/*"]  // Mas a pasta src não existe!\n}

Neste exemplo, a pasta src está ausente. O compilador tenta honestamente encontrar arquivos pelo padrão src/**/*, não encontra — e exibe o erro.

Como corrigir:

\n
• Verifique se a pasta que você especificou em include existe.
\n
• Certifique-se de que essa pasta contém arquivos .ts ou .tsx.
\n
• Use caminhos relativos. Se seu tsconfig.json está na raiz e os fontes em src/, escreva "src/**/*".
\n

Configuração correta:

{\n  "compilerOptions": {\n    "target": "ES2020",\n    "module": "commonjs",\n    "outDir": "./dist"\n  },\n  "include": ["src/**/*"]\n}\n// Certifique-se de que a pasta src existe e contém arquivos .ts

Causa nº 3: Conflito entre include e exclude

Às vezes você especifica uma pasta em include, mas depois em exclude ex