Guia de sintaxe e regras de padrões do .gitignore

Cada linha em um arquivo .gitignore define um padrão de exclusão independente com três regras básicas:

• Linhas em branco são ignoradas e servem como separadores visuais para organizar o documento.
• Linhas iniciadas com # são comentários e não exercem efeito sobre o controle de versão.
• Espaços no final da linha são ignorados, a menos que sejam escapados com barra invertida (\ ).

# Ignore compiled Python bytecode
__pycache__/
*.py[cod]

# Ignore local secret configurations
.env
.env.local

O Git suporta os padrões tradicionais glob de shell em um único nível de pasta:

• * (Asterisco): Corresponde a zero ou mais caracteres em um mesmo segmento. *.log casa com error.log, mas não com pasta/error.log.
• ? (Ponto de interrogação): Corresponde a exatamente um caractere único. test?.js casa com test1.js, mas não com test12.js.
• [abc] (Intervalo de caracteres): Corresponde a qualquer caractere contido entre os colchetes. *.[oa] casa com arquivos terminados em .o ou .a.

A posição das barras (/) muda totalmente a forma como o Git avalia cada linha:

• Barra final (logs/): Restringe a regra exclusivamente a pastas. Uma pasta logs/ será ignorada, mas um arquivo regular chamado logs não será ignorado.
• Barra inicial (/config.json): Ancora a regra na raiz do repositório onde reside o arquivo .gitignore. Ignora /config.json, mas permite rastrear /sub/config.json.
• Barra intermediária (docs/*.html): Ancora o padrão em relação à pasta onde está o arquivo .gitignore.

O asterisco duplo casa padrões através de múltiplos níveis de pastas aninhadas:

• **/cache: Corresponde a qualquer pasta ou arquivo chamado cache em qualquer lugar do repositório (cache, src/cache, a/b/c/cache).
• logs/**: Corresponde a todos os arquivos e subpastas dentro de logs/, em qualquer profundidade.
• a/**/b: Corresponde a a/b, a/x/b, a/x/y/b e assim sucessivamente.

Um ponto de exclamação (!) no início nega uma regra anterior, orientando o Git a voltar a rastrear um arquivo.

Para incluir um arquivo específico dentro de uma pasta ignorada, você deve ignorar o conteúdo da pasta e não a pasta em si:

# INCORRECT: Will NOT work because parent directory is skipped
node_modules/
!node_modules/my-local-package

# CORRECT: Ignore contents of directory, then whitelist the specific target
node_modules/*
!node_modules/my-local-package/

Para checar exatamente qual regra do .gitignore está descartando ou deixando passar um arquivo, use o utilitário nativo com a opção -v:

# Shows the exact .gitignore file and line number responsible
git check-ignore -v src/temp/debug.log