Skip to content
Documentação Técnica e Referência

Guias e Referências de .gitignore

Guias técnicos aprofundados sobre sintaxe, mecânica de padrões e resolução de problemas comuns de exclusão no Git.

Guias e Referências de .gitignore

Syntax
6 min read de leituraVerificado no Git 2.40+

Guia de sintaxe e padrões no .gitignore

Explicação abrangente sobre formato de regras, globbing, barras iniciais e finais, particularidades da negação e intervalos de caracteres no Git.

Workflows
5 min read de leituraVerificado no Git 2.40+

Como ignorar um diretório no Git

Explicação clara das regras para pastas: semântica da barra final, caminhos relativos à raiz, subpastas e manutenção de pastas vazias.

Perguntas Frequentes

Respostas práticas para dúvidas comuns de desenvolvedores sobre regras de .gitignore, cache e configuração de repositórios.

Por que o Git continua rastreando um arquivo depois de adicioná-lo ao .gitignore?

O .gitignore só impede o rastreamento de arquivos recém-adicionados. Se um arquivo já foi comitado, o Git continuará rastreando-o até que seja removido do índice com 'git rm --cached <arquivo>'.

Como verificar qual regra está ignorando um arquivo específico?

Execute 'git check-ignore -v <caminho>'. O Git exibirá o caminho exato do arquivo .gitignore e o número da linha correspondente.

Por que '!pasta/arquivo.txt' falha quando 'pasta/' está no .gitignore?

O Git não percorre diretórios que já foram completamente excluídos. Para liberar um arquivo dentro de uma pasta ignorada, ignore seu conteúdo com 'pasta/*' e use '!' para resgatar o arquivo desejado.

Qual é a diferença entre 'build' e 'build/' no .gitignore?

'build/' corresponde exclusivamente a diretórios. 'build' sem barra corresponde tanto a diretórios quanto a arquivos comuns com esse nome.

Como manter uma pasta vazia em um repositório Git?

O Git rastreia apenas arquivos, nunca pastas vazias. Crie um arquivo vazio chamado .gitkeep dentro da pasta, ignore o conteúdo com 'pasta/*' e libere '!pasta/.gitkeep'.

Onde devo ignorar arquivos do meu editor e sistema operacional (.DS_Store, .vscode)?

Use um arquivo de exclusão global configurando 'git config --global core.excludesFile ~/.gitignore_global' para não poluir os repositórios compartilhados da equipe.