Padrões de caminhos no repositório
O .gitignore é um arquivo de texto que define padrões de caminhos para o Git ignorar arquivos ainda não rastreados. Ele é usado para manter arquivos locais ou gerados fora das inclusões habituais no versionamento. Cada linha declara um padrão que o Git compara com os caminhos encontrados.
Um padrão como *.log corresponde a nomes terminados em .log. A barra no fim de cache/ restringe esse padrão a diretórios. A posição do .gitignore determina quais caminhos ele abrange.
Consulta do padrão aplicado a um arquivo
Este exemplo usa um .gitignore na raiz do repositório com uma única linha:
*.logPara consultar um arquivo debug.log ainda não rastreado na mesma raiz, você pode executar:
git check-ignore -v debug.logA opção -v mostra o arquivo que forneceu o padrão, o número da linha e o padrão correspondente ao caminho consultado. Nesse exemplo, a saída indica .gitignore, a linha 1 e *.log. Isso permite conferir por que o Git ignora o arquivo.
Arquivos já rastreados ficam fora dessa consulta por padrão. Acrescentar *.log ao .gitignore não retira do versionamento um debug.log previamente adicionado. Você precisa conferir o estado do arquivo no repositório para distinguir um padrão que não corresponde ao nome de um arquivo que já está rastreado.
Dúvidas frequentes
Perguntas frequentes sobre .gitignore
- Adicionar um arquivo ao .gitignore o retira do histórico?
- Os padrões não afetam arquivos já rastreados nem apagam commits anteriores. Uma credencial que já entrou no histórico continua exposta ali e precisa ser revogada no serviço correspondente.
- Pode existir um .gitignore em um subdiretório?
- Pode. Os padrões são interpretados em relação ao diretório do .gitignore. Para os caminhos abrangidos, padrões de um arquivo mais próximo podem substituir os definidos nos diretórios superiores.
- Um arquivo ignorado pode ser adicionado ao Git?
- O comando git add normalmente omite arquivos ignorados, mas a opção -f permite incluí-los explicitamente. O .gitignore também não altera as permissões de leitura do sistema.
Para continuar
Recursos relacionados
Documentação
Git: padrões de arquivos ignorados
Manual dos padrões do .gitignore, com sintaxe, precedência e limites para arquivos já rastreados.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Para investigar um arquivo que continua aparecendo no versionamento, o Desenvolvimento Colaborativo oferece orientação ao vivo com você no editor e no terminal.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao desenvolver com agentes, você precisa conferir quais arquivos locais devem ficar fora do versionamento e quais já estão rastreados pelo Git.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.