Sobre o Gerador de .gitignore
Esta ferramenta usa sem alterações a coleção oficial de templates mantida pelo GitHub, github/gitignore, combina vários templates em um único arquivo e organiza as regras repetidas. Você pode verificar na hora quais arquivos as regras criadas realmente ignoram no testador de padrões, implementado com as mesmas regras de correspondência do git. Todo o processamento termina dentro do navegador, e as regras e os caminhos digitados não são enviados a nenhum servidor.
Principais recursos
- Busca e seleção múltipla entre 312 templates — Busque pelo nome templates de linguagens e frameworks, de SO, editores e ferramentas, e da comunidade, e combine vários em um único arquivo. Com a tecla Enter você adiciona direto o primeiro resultado.
- Remoção de duplicatas que preserva o significado — Se vários templates têm a mesma regra, a que aparece depois é removida. Mas, se houver uma regra de negação `!` entre as duas, o resultado pode mudar, então ela é mantida.
- Comentários de seção e comentários originais — Cada template recebe um comentário de seção com o caminho de origem, para que depois se saiba de onde veio cada regra. Também é possível remover os comentários originais e deixar só as regras.
- Combinações populares predefinidas — Selecione de uma vez combinações comuns como Node + macOS + VS Code, Java + Maven + IntelliJ ou Unity + Visual Studio.
- Testador de padrões — Cole uma lista de caminhos e veja se são ignorados e qual regra decidiu (com número da linha). Avalia a negação `!`, a `/` final, `**`, a ancoragem e a exclusão de diretórios pai da mesma forma que o git.
- Comandos para parar de rastrear — Gera para bash/zsh e PowerShell os comandos que tiram do rastreamento com `git rm --cached` os arquivos já commitados.
- Copiar, baixar e compartilhar link — Copie o resultado ou salve-o como arquivo `.gitignore`. Os templates selecionados ficam no endereço (`?t=`), então dá para compartilhá-los por link.
Como usar
- Busque templates na lista à esquerda e marque-os, ou clique em um botão de Combinações populares. O comum é escolher 1 ou 2 linguagens/frameworks mais o SO e o editor que você usa.
- Confira o resultado à direita. Mudanças nas opções Remover regras duplicadas, Comentários de seção e Manter comentários originais são aplicadas na hora. Escreva as regras específicas do projeto em Regras próprias.
- Use Copiar ou Baixar para criar o
.gitignorena raiz do repositório. Se o navegador salvar o arquivo comogitignore, renomeie-o colocando o ponto na frente. - Ao clicar em Testar, as regras vão para a aba de teste de padrões. Cole caminhos do repositório para confirmar que são ignorados como esperado (a saída de
git ls-filesoufind . -type fé prática). - Se um arquivo já commitado não for ignorado, gere os comandos na aba Parar de rastrear, execute-os e faça o commit.
Dados de templates e licença
Os 312 templates correspondem ao commit 356fd7b (2026-09-11) do repositório github/gitignore. Esse repositório é distribuído sob CC0-1.0 (dedicação ao domínio público), então pode ser copiado, modificado e redistribuído livremente. A pasta raiz contém linguagens e frameworks, Global contém SO, editores e ferramentas, e community contém templates especializados. As explicações de cada template e os textos deste site foram escritos por este site.
Perguntas frequentes
Adicionei ao .gitignore, mas o arquivo continua aparecendo no git status.
O .gitignore só se aplica a arquivos que ainda não são rastreados. Um arquivo já commitado só passa a ser ignorado depois de retirado do índice com git rm --cached <arquivo> e de um commit. Você pode gerar os comandos na aba Parar de rastrear.
Incluí de novo com `!`, mas ele continua ignorado.
Se o próprio diretório pai está excluído, o git não olha dentro dele, então não é possível recuperar um arquivo interno com !. Em vez de logs/, exclua só o conteúdo do diretório com logs/* e depois use !logs/keep.txt. O testador de padrões marca esse caso como 'Ignorado (diretório pai)'.
A remoção de duplicatas não muda o significado das regras?
O git segue a última regra que corresponde. Se a mesma regra aparece de novo e não há nenhuma regra ! entre as duas, apagar a posterior dá o mesmo resultado. Se houver uma regra de negação no meio, esta ferramenta não remove a duplicata e a mantém.
Os resultados do testador de padrões são iguais aos do git?
Ele foi implementado seguindo a documentação gitignore(5) e o comportamento do wildmatch do git, e a correspondência foi confirmada comparando milhares de padrões e caminhos aleatórios com os resultados reais de git ls-files --ignored. Porém, ele não considera os .gitignore de subdiretórios, .git/info/exclude nem a configuração global, então para o veredito do repositório inteiro use git check-ignore -v.
As regras de macOS e VS Code devem ir no .gitignore do projeto?
Os arquivos gerados pelo SO e pelo editor pertencem ao ambiente pessoal, por isso o recomendado é colocá-los em um gitignore global definido com core.excludesFile. Ainda assim, muitas equipes também os incluem no arquivo do projeto, porque é comum que os membros não façam a configuração global.
Quão atualizados estão os dados de templates?
O repositório github/gitignore é baixado por um script de build e incluído no site. O commit e a data de referência aparecem na página Sobre, no rodapé da lista de templates e no comentário de cabeçalho do resultado gerado.
O que eu digito é salvo ou enviado?
Não. A geração, os testes e a criação de comandos rodam no navegador. Apenas o tema claro/escuro e as opções de geração são salvos no localStorage deste navegador.