Anúncios incomodam? Ir Sem anúncios Hoje

Gerador de tsconfig.json

DadosDesenvolvedor
ANUNCIADO Remover?

Idioma & Módulos

Versão do JavaScript a ser compilada.
Sistema de módulos para o código emitido.
Como o compilador resolve especificadores de importação.
Modo de emissão do JSX. Obrigatório para projetos React.
Bibliotecas padrão separadas por vírgula (deixe em branco para usar o padrão do target). Exemplos: ES2022, DOM, DOM.Iterable, WebWorker, ESNext.

Layout do Projeto

Pasta raiz dos arquivos de entrada. Deixe em branco para inferir.
Pasta de saída para arquivos emitidos. Deixe em branco para emitir ao lado da origem.
Pasta base para imports não relativos. Obrigatório se você definir aliases de caminho.
Aliases de caminho, um por linha como alias=destino. Use * para wildcards. Exemplo: @/*=src/*
Padrões glob para incluir, um por linha. Padrão é todos os arquivos do projeto se estiver vazio.
Padrões glob para excluir, um por linha.

Rigor

Validação

Emissão & Interoperabilidade

Opções de Saída

ANUNCIADO Remover?

Guia

gerador de tsconfig.json

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

  1. 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.
  2. Ajuste o Seção de Idioma & Módulos se o ambiente de execução precisar de um diferente target, module, ou moduleResolution. Defina jsx se você estiver compilando React.
  3. Defina o Layout do Projeto campos (rootDir, outDir, baseUrl) para corresponder à estrutura de pastas. Adicione aliases de caminho um por linha como alias=target (por exemplo @/*=src/*).
  4. Use o Rigor e Validação caixas de seleção para optar por verificações individuais do compilador. strict habilita a família completa de configurações estritas em um clique.
  5. O Emissão & Interoperabilidade seção controla como os arquivos são gerados e como as importações padrão funcionam. Ative declaration para bibliotecas ou noEmit quando um bundler gerencia a saída.
  6. 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 baseUrl quando 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ássico react, ou preserve para 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 include e exclude padrões com padrões sensíveis por perfil pré-definido.
  • Modo de biblioteca – O perfil de biblioteca ativa declaration, declarationMape, e sourceMap para que os consumidores recebam tipos completos.
  • Copiar ou baixar – Solte o resultado no seu repositório com um clique.

ANUNCIADO Remover?

Perguntas frequentes

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

Quer eliminar anúncios? Fique sem anúncios hoje mesmo

Instale nossas extensões

Adicione ferramentas de IO ao seu navegador favorito para acesso instantâneo e pesquisa mais rápida

Ao Extensão do Chrome Ao Extensão de Borda Ao Extensão Firefox Ao Extensão Opera

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!

ANUNCIADO Remover?
ANUNCIADO Remover?
ANUNCIADO Remover?

Notícias com destaques técnicos

Envolver-se

Ajude-nos a continuar fornecendo ferramentas gratuitas valiosas

Compre-me um café
ANUNCIADO Remover?