Como usar
- Marque as linguagens, os frameworks, os editores e os sistemas operacionais que seu projeto usa. Use Limpar tudo para recomeçar.
- Leia Seu arquivo .gitignore. Cada modelo tem seu próprio rótulo, e uma linha que outro modelo já lista aparece só uma vez.
- Clique em Copiar ou Baixar, e salve o texto como um arquivo chamado .gitignore na pasta de nível mais alto do seu projeto.
Como os modelos são unidos
Cada modelo escolhido vira uma seção, começando com uma linha de rótulo, como # ==== Node ====. As seções seguem a ordem das listas da página, então a mesma escolha sempre gera o mesmo arquivo.
- Um padrão que já está no arquivo é deixado de fora quando aparece de novo.
- Um comentário que já está no arquivo é deixado de fora do mesmo modo.
- Linhas em branco são mantidas entre as linhas e removidas no início e no fim de cada seção.
- Um modelo cujas linhas são todas listadas por modelos anteriores não acrescenta nada, então não recebe linha de rótulo.
Linhas repetidas e o sinal !
O Git lê os padrões de um arquivo .gitignore em ordem, e um padrão posterior substitui um anterior. Um padrão que começa com ! inclui de novo um arquivo que um padrão anterior excluiu (gitignore(5)). Por isso, um padrão repetido só é deixado de fora quando as linhas entre suas duas cópias são do mesmo tipo que ele: se o padrão exclui, nenhuma linha entre as cópias pode começar com !, e se ele começa com !, nenhuma linha entre elas pode excluir. Caso contrário, a repetição fica, porque muda o resultado.
De onde vêm os modelos
Os 51 modelos são cópias de arquivos do github/gitignore, a coleção de modelos que o GitHub oferece para novos repositórios. A coleção é publicada sob a licença CC0 1.0 Universal, que coloca os modelos em domínio público. As linhas de cada modelo são mantidas como estão, exceto pela união. Os rótulos das seções usam os nomes dos projetos, que não são traduzidos.
O que o arquivo não cobre
- Ele não sabe quais arquivos as suas próprias ferramentas criam. Acrescente essas linhas você mesmo, por exemplo uma pasta de envios ou um arquivo de configurações local.
- Um padrão afeta apenas arquivos que o git ainda não rastreia. Um arquivo que já é rastreado continua sendo rastreado até você executar git rm --cached nele.
- Arquivos do editor e do sistema costumam pertencer a um arquivo global de exclusão (core.excludesFile), para que todo projeto no seu computador os ignore sem uma linha no arquivo do projeto.
Exemplo resolvido: C e C++
Escolher C e depois C++ gera um arquivo com 77 linhas de padrão e de comentário. A seção de C acrescenta 46 linhas. A seção de C++ acrescenta 31 linhas e deixa de fora 23 que a seção de C já lista, como *.o, *.obj e *.so. Nada entre essas cópias começa com !, então as repetições são deixadas de fora.
| Modelo | Linhas acrescentadas | Linhas deixadas de fora |
|---|---|---|
| C | 46 | 0 |
| C++ | 31 | 23 |
Perguntas frequentes
O arquivo .gitignore é enviado para algum servidor?
Não. Os modelos vêm junto com a página e a união é feita no seu navegador, então o arquivo que você monta fica no seu dispositivo até você salvá-lo.
Por que uma linha aparece só uma vez quando dois modelos a têm?
A união mantém a primeira cópia e deixa de fora as cópias seguintes, porque um padrão repetido não muda nada. A exceção é uma repetição depois de uma linha que começa com !, que pode mudar o resultado, então essa cópia fica.
Um arquivo .gitignore faz o git parar de rastrear um arquivo que já é rastreado?
Não. Um padrão só afeta arquivos que o git ainda não rastreia. Para parar de rastrear um arquivo que já está no repositório, execute git rm --cached nele, e então o padrão passa a valer para ele.
Arquivos do editor e do sistema devem ir no .gitignore do projeto?
Podem, mas um arquivo global de exclusão definido com core.excludesFile costuma ser melhor. Ele vale para todos os projetos do seu computador, então o arquivo do projeto guarda só as linhas que importam para o próprio projeto.
Os modelos estão atualizados?
São cópias dos arquivos do github/gitignore como estavam quando esta ferramenta foi atualizada pela última vez. O repositório muda com o tempo, então pode existir uma versão mais nova de um modelo no GitHub.
Fontes
- github/gitignore (em inglês): the template collection (CC0 1.0 Universal)
- gitignore(5) (em inglês): pattern rules, from the Git documentation
- CC0 1.0 Universal (em inglês): the licence of the templates
Números e texto verificados pela última vez em terça-feira, 10 de novembro de 2026.