Um arquivo com a extensão de arquivo GITIGNORE é um arquivo Git Ignore usado com o sistema de controle de versão/fonte chamado Git.
O que é um arquivo GITIGNORE?
Um arquivo Git Ignore especifica quais arquivos e pastas devem ser ignorados em um determinado código-fonte.
Ele pode ser usado por caminho para que as regras sejam aplicadas apenas a pastas específicas, mas você também pode criar um arquivo GITIGNORE global que se aplica a todos os repositórios Git que você possui.
Você pode encontrar dezenas de exemplos de arquivos GITIGNORE que são recomendados em vários cenários, na página de templates.gitignore do GitHub.
Como abrir um arquivo GITIGNORE
GITIGNORE arquivos são arquivos de texto simples, o que significa que você pode abrir um com qualquer programa que possa ler arquivos de texto.
Os usuários do Windows podem abrir arquivos GITIGNORE com o programa Notepad integrado ou com o aplicativo gratuito Notepad++. Para abrir arquivos GITIGNORE no macOS, você pode usar o Gedit. Usuários de Linux (assim como Windows e macOS) podem achar o Atom útil para abrir e editar arquivos GITIGNORE.
No entanto, os arquivos GITIGNORE não são realmente utilizáveis (ou seja, eles não funcionam como um arquivo ignorado), a menos que sejam utilizados no contexto do Git, que é um software livre que roda no Windows, Linux e macOS.
Você pode usar o arquivo GITIGNORE colocando-o onde quer que as regras se apliquem. Coloque um diferente em cada diretório de trabalho e as regras de ignorar funcionarão para cada pasta individualmente. Se você colocar o arquivo GITIGNORE na pasta raiz do diretório de trabalho do projeto, poderá adicionar todas as regras para que ele assuma uma função global.
Não coloque o arquivo GITIGNORE no diretório do repositório Git; que não permitirá que as regras se apliquem, pois o arquivo precisa estar no diretório de trabalho.
Os arquivos GITIGNORE são úteis para compartilhar as regras de ignorar com qualquer outra pessoa que possa clonar seu repositório. É por isso que, de acordo com o GitHub, é importante enviá-lo para o seu repositório.
Como converter de/para um arquivo GITIGNORE
Veja este tópico do Stack Overflow para obter informações sobre a conversão de CVSIGNORE para GITIGNORE. A resposta simples é que não existe um conversor de arquivo regular que possa fazer isso por você, mas pode haver um script que você pode usar para copiar os padrões do arquivo CVSIGNORE.
Veja Como Converter Repositórios SVN em Repositórios Git para obter ajuda. Além disso, veja este script Bash que pode conseguir a mesma coisa.
Para salvar seu arquivo GITIGNORE em um formato de arquivo de texto, use um dos editores de texto mencionados acima. A maioria deles pode converter para TXT, HTML e formatos de texto simples semelhantes.
Leitura Avançada em Arquivos GITIGNORE
Você pode construir um arquivo GITIGNORE local a partir do Terminal, com este comando:
toque em.gitignore
Um global pode ser feito assim:
git config --global core.excludesfile ~/.gitignore_global
Alternativamente, se você não quiser criar um arquivo GITIGNORE, você pode adicionar exclusões ao seu repositório local editando o arquivo.git/info/exclude.
Aqui está um exemplo simples de um arquivo GITIGNORE que ignoraria vários arquivos gerados pelo sistema operacional:
. DS_Store
. DS_Store?
._. Lixeiras
ehthumbs.dbThumbs.db
Aqui está um exemplo GITIGNORE que exclui arquivos LOG, SQL e SQLITE do código fonte:
.log
.sql.sqlite
Existem muitas regras de padrão que devem ser seguidas para cumprir as regras de sintaxe adequadas que o Git exige. Você pode ler sobre isso, e muito mais sobre como o arquivo funciona, no site oficial de documentação do GITIGNORE.
Certifique-se de lembrar que se você já fez check-in de um arquivo para não ser ignorado, e depois adicionar uma regra de ignorar para ele no arquivo GITIGNORE, o Git não irá ignorar o arquivo até que você o desrastreie com o seguinte comando:
git rm --nome do arquivo em cache
Seu arquivo ainda não está abrindo?
Se seu arquivo não estiver funcionando como descrito acima, verifique se você está lendo a extensão do arquivo corretamente. Por exemplo, se você não puder abri-lo com um editor de texto ou se o Git não reconhecer o arquivo, você pode não estar lidando com um arquivo GITIGNORE.
IGN é outro arquivo para ignorar, mas está no formato de arquivo RoboHelp Ignore List criado e usado com o Adobe RoboHelp para criar documentos de ajuda do Windows. Embora o arquivo possa ter uma função semelhante - para listar palavras que são ignoradas nas pesquisas na documentação - ele não pode ser usado com o Git e não segue as mesmas regras de sintaxe.
Se o arquivo não abrir, pesquise a extensão do arquivo para saber em que formato está, para que você possa encontrar o software apropriado que o abre ou converte.
FAQ
Como vejo o que está no meu GITIGNORE?
Você pode abrir o arquivo com o editor de texto escolhido. Você também pode usar o comando git check-ignore pathname para ver se um arquivo específico está na lista de ignorados.
O que é GITIGNORE e GITATTRIBUTES no Visual Studio?
O arquivo GITIGNORE lista os itens não rastreados por um repositório Git, enquanto o arquivo GITATTRIBUTES especifica como lidar com arquivos específicos com base no nome do caminho. Você pode abrir e alterar ambos os arquivos no Visual Studio a partir de Repository Settings > Ignore & Attributes Files
Como faço para GITIGNORE uma pasta?
Se você quiser ignorar o conteúdo de um diretório específico, abra seu arquivo GITIGNORE e digite folder_name /.
