Gerar e testar .gitignore

Selecione os ambientes usados no projeto e teste caminhos na saída gerada. Para casos especiais de correspondência, confirme o comportamento no Git.

Funciona localmente no seu navegador
Esta ferramenta processa todos os dados localmente no seu navegador.
Grupos predefinidosSelecione somente os ambientes usados pelo seu repositório.
Caminhos representativosOne repository-relative path per line, matched exactly as typed.

Como montar e testar um arquivo .gitignore

Escolha os grupos predefinidos de que o projeto precisa e clique em Gerar .gitignore. Os onze grupos seguem as listas usuais de Node.js, Python, PHP/Composer, Java/Gradle, Go, Rust, macOS, Windows, VS Code, JetBrains e arquivos de ambiente locais; linhas idênticas aparecem uma única vez e cada grupo mantém o próprio comentário e a linha em branco.

O painel de caminhos é o testador. Digite um caminho relativo ao repositório por linha e clique em Testar caminhos: cada linha é comparada com os padrões gerados e o relatório responde ignorado ou incluído junto com o padrão que decidiu. A comparação segue as regras do gitignore(5): padrão com barra é ancorado na raiz do repositório, * não atravessa barras, ** atravessa, ? é um caractere, [abc] é uma classe de caracteres, a barra final restringe a diretórios e tudo abaixo de um diretório ignorado continua ignorado.

  1. Selecione os grupos predefinidos. Node.js, macOS, VS Code e Environment secrets já vêm marcados; desmarque o que o repositório não usa.
  2. Clique em Gerar .gitignore. O painel de saída traz o arquivo combinado: um comentário por grupo, sem linhas duplicadas, com negações como !.env.example e quebra de linha no final.
  3. Digite os caminhos de teste no painel do meio: um por linha, relativos à raiz do repositório e sem barra inicial. Espaços contam, como no Git.
  4. Clique em Testar caminhos. Cada linha indica ignorado ou incluído e o padrão que decidiu; os avisos abaixo listam os casos que o Git trata de outra forma.
  5. Copie o arquivo ou baixe-o como .gitignore, ou clique em Limpar para recomeçar. Os grupos ficam no script da página, então nada é enviado.

O que o testador decide e onde ele para

Como os grupos são combinados

Cada grupo é uma lista fixa de linhas. O gerador escreve os grupos selecionados na ordem das caixas, pula uma linha que já apareceu antes e mantém uma linha em branco entre grupos. As negações dos grupos de VS Code e de ambiente são linhas normais e permanecem como estão.

Nada é baixado ao gerar: as listas vêm do script da página, então a mesma seleção produz sempre o mesmo texto e o arquivo pode ser montado offline.

Como um caminho é testado

O testador converte cada linha do arquivo gerado em um padrão e percorre o caminho da raiz do repositório para baixo. Uma correspondência em um diretório pai decide o caminho antes das regras dele: é por isso que .vscode/settings.json continua ignorado na seleção padrão mesmo com !.vscode/settings.json no arquivo.

Um caminho digitado sem barra final é testado como arquivo e depois como diretório, então uma regra como logs/ também cobre o caminho escrito como logs. O relatório mostra o padrão que decidiu cada linha, incluindo as negações.

O que os avisos significam

Duas condições são sinalizadas no arquivo gerado: um padrão terminado em espaço não escapado (o Git remove o espaço antes de comparar) e uma negação cujo diretório pai está excluído (o Git não desce até lá, então a negação não reinclui nada).

Todo relatório termina com o mesmo limite: arquivos .gitignore aninhados, core.excludesFile, sistemas de arquivos sem distinção de maiúsculas e o restante do motor completo do Git ficam fora deste teste.

Ferramentas recentes: