Gerador de tsconfig.json
Guia
Gerador de tsconfig.json
Gerar um arquivo válido tsconfig.json para projetos TypeScript sem precisar memorizar nomes de opções ou procurar as notas de lançamento para saber o que mudou na versão mais recente do compilador. Escolha um perfil pré-definido (Node ESM, Node CommonJS, React, Next.js, Biblioteca ou Mais Rigoroso), ajuste os interruptores de rigor, adicione quaisquer aliases de caminho e copie o JSON gerado para a raiz do seu projeto.
A configuração do compilador do TypeScript é uma superfície afiada: os nomes das opções são sensíveis a maiúsculas e minúsculas, a lista cresce com cada lançamento, e uma chave mal escrita ou desatualizada pode gerar a saída incorreta silenciosamente, em vez de falhar rapidamente. Um gerador baseado em formulário que apenas emite as opções marcadas é a maneira mais rápida de obter uma configuração funcional que corresponda ao seu projeto e ao seu pipeline de compilação e build.
Como usar
- Abra o Perfil Pré-definido dropdown e escolha a opção mais próxima para seu projeto. O formulário preenche valores sensíveis para o target, sistema de módulos, modo JSX e flags recomendadas.
- Ajuste o Seção de Idioma & Módulos se o ambiente de execução precisar de um diferente
target,module, oumoduleResolution. Definajsxse você estiver compilando React. - Defina o Layout do Projeto campos (
rootDir,outDir,baseUrl) para corresponder à estrutura de pastas. Adicione aliases de caminho um por linha comoalias=target(por exemplo@/*=src/*). - Use o Rigor e Validação caixas de seleção para optar por verificações individuais do compilador.
stricthabilita a família completa de configurações estritas em um clique. - O Emissão & Interoperabilidade seção controla como os arquivos são gerados e como as importações padrão funcionam. Ative
declarationpara bibliotecas ounoEmitquando um bundler gerencia a saída. - Copie a configuração gerada do painel de saída ou baixe diretamente como
tsconfig.json.
Características
- Perfis Pré-definidos – Node (ESM e CommonJS), React, Next.js App Router, Biblioteca e um perfil mais rigoroso para projetos novos.
- Todas as versões modernas do target – ES5 até ES2023 mais ESNext, com sistemas de módulos correspondentes incluindo NodeNext e resolução do bundler.
- Construtor de aliases de caminho – Digite um alias por linha; o gerador conecta automaticamente
baseUrlquando aliases estão presentes. - Rigor granular – Ative
noUncheckedIndexedAccess,exactOptionalPropertyTypese outros sinais individuais da família estrita. - Suporte ao JSX – Escolha entre
react-jsx,react-jsxdev, clássicoreact, oupreservepara bundlers. - Comentários inline – Cada opção pode ser anotada com uma explicação curta para que o arquivo resultante se documente sozinho.
- Inclusão e exclusão de padrões glob – Entrada multilinha para
includeeexcludepadrões com padrões sensíveis por perfil pré-definido. - Modo de biblioteca – O perfil de biblioteca ativa
declaration,declarationMape, esourceMappara que os consumidores recebam tipos completos. - Copiar ou baixar – Solte o resultado no seu repositório com um clique.
Perguntas frequentes
-
O que é tsconfig.json e por que o TypeScript precisa disso?
O arquivo tsconfig.json é o arquivo de configuração lido pelo compilador TypeScript para decidir quais arquivos pertencem a um projeto e como compilá-los. A presença desse arquivo em um diretório marca esse diretório como raiz de um projeto TypeScript. Sem ele, o compilador ainda funciona para arquivos isolados, mas ferramentas como editores, pipelines de build e integrações de lint dependem dele para compartilhar uma visão consistente do código, do ambiente de execução e da rigidez de verificação de tipos.
-
Qual a diferença entre módulo e moduleResolution?
módulo controla a sintaxe do JavaScript que o TypeScript emite — CommonJS com require/export, módulos ES com import/export ou uma mistura como NodeNext. moduleResolution é independente e controla como os especificadores de importação são procurados no disco — por exemplo, se um import sem extensão resolve para um arquivo .ts, se os campos de exportação do package.json são respeitados e se um resolutor de bundler é assumido. Projetos modernos com um bundler geralmente combinam module: ESNext com moduleResolution: Bundler; projetos puros do Node sem um bundler combinam module: NodeNext com moduleResolution: NodeNext.
-
O que realmente ativa strict?
strict é uma bandeira meta que ativa a família completa de configurações rígidas em uma única opção: noImplicitAny, strictNullChecks, strictFunctionTypes, strictBindCallApply, strictPropertyInitialization, noImplicitThis, alwaysStrict e useUnknownInCatchVariables. Flags adicionadas futuramente pelo compilador também são incluídas automaticamente. As bandeiras individuais ainda podem ser definidas explicitamente para sobrescrever o valor padrão de strict, mas a maioria dos novos projetos deve deixar strict ligado e adicionar opções mais rigorosas, como noUncheckedIndexedAccess, ao lado.
-
Como as aliases de caminho funcionam com baseUrl?
paths define uma correspondência de especificadores de importação para locações reais de arquivos, e a busca acontece em relação ao baseUrl. Por exemplo, baseUrl: "." e paths: { "@/*": ["src/*"] } significa que um import de @/utils resolve para ./src/utils. Aliases de caminho afetam apenas a verificação de tipos; bundlers, executadores de testes e o ambiente de execução precisam de sua própria configuração equivalente (Vite resolve.alias, Jest moduleNameMapper, campo imports do Node) para que os mesmos caminhos funcionem em tempo de execução.
-
Em que situações o noEmit deve ser habilitado?
noEmit é para projetos onde outra ferramenta — geralmente um bundler como Vite, esbuild, webpack ou Next.js — produz a saída em JavaScript, e o TypeScript é usado apenas para verificação de tipos. Com noEmit ligado, o compilador valida os tipos mas não cria arquivos. Também é útil em ambientes de CI para um passo rápido de verificação de tipos. Para projetos de bibliotecas publicadas no npm, deixe noEmit desligado para que o compilador possa emitir arquivos .js e .d.ts ao lado do código fonte.
Instale nossas extensões
Adicione ferramentas de IO ao seu navegador favorito para acesso instantâneo e pesquisa mais rápida
恵 O placar chegou!
Placar é uma forma divertida de acompanhar seus jogos, todos os dados são armazenados em seu navegador. Mais recursos serão lançados em breve!
Ferramentas essenciais
Ver tudo Novas chegadas
Ver tudoAtualizar: Nosso ferramenta mais recente foi adicionado em 6 de junho de 2026
