Ir para o conteúdo

Testador de Glob e .gitignore

Teste padrões glob (*, **, ?, [...]) contra uma lista de caminhos e veja o match ao vivo, ou entre no modo .gitignore para descobrir exatamente qual linha decide se um arquivo é ignorado.

Privacidade e escopo: tudo roda no seu navegador — nenhum padrão ou caminho sai da máquina. O matching é feito por algoritmo direto, sem conversão para expressão regular — a causa clássica de travamento em testadores de padrão (ReDoS) não se aplica aqui.

Testar padrão

Modo

3 de 4 caminhos casaram com o padrão.

Resultado (3 de 4 casaram)

CaminhoResultado
src/app.ts✓ Casou
src/utils/helper.ts✓ Casou
dist/app.js✗ Não casou
src/app.spec.ts✓ Casou

Explicação do padrão

  • / — Padrão ancorado na raiz — casa a partir do início do caminho, não em qualquer nível.
  • s — Caractere literal "s".
  • r — Caractere literal "r".
  • c — Caractere literal "c".
  • / — Separador de diretório.
  • ** — Qualquer sequência de caracteres, incluindo "/" — cruza qualquer número de diretórios.
  • / — Separador de diretório.
  • * — Qualquer sequência de caracteres, exceto "/" (não cruza diretórios).
  • . — Caractere literal ".".
  • t — Caractere literal "t".
  • s — Caractere literal "s".

O que é um padrão glob

Glob é uma gramática compacta para descrever conjuntos de caminhos de arquivo — usada por .gitignore, filtros paths: de CI (GitHub Actions), e opções --exclude/--include de rsync/tar. Diferente de regex, glob é deliberadamente simples: só existem quatro construções (*, **, ?, [...]), sem grupos, alternância ou quantificadores numéricos.

Glob vs. regex — a confusão nº 1

Quem já conhece regex tende a assumir que * em glob se comporta como .* em regex (qualquer coisa, incluindo barras). Não é o caso: em glob, *nunca cruza um "/" — só ** cruza diretórios. Essa diferença de semântica é a razão pela qual um padrão como src/*.log não pega arquivos dentro de src/sub/, enquanto src/**/*.log pega. Se o que você precisa validar é um texto qualquer (não um caminho de arquivo), use o Testador de Regex em vez desta ferramenta.

A armadilha da negação em .gitignore

O .gitignore aplica suas regras na ordem em que aparecem, e a última linha que casa um caminho decide — uma linha com !padrão reinclui um arquivo previamente excluído. Mas há uma exceção que confunde muita gente: se uma regra excluiu um diretório inteiro (como logs/), o Git nem desce dentro dele para avaliar as regras seguintes — então !logs/keep.log depois de logs/não tem efeito nenhum, e logs/keep.log continua ignorado. Essa é a causa nº 1 real de "meu ! não funciona". A correção é evitar ignorar o diretório inteiro quando você sabe que vai precisar reincluir algo lá dentro — por exemplo, use logs/*.log em vez de logs/ se quiser manter a porta aberta para negações específicas depois.

Por que "{a,b}" não funciona em .gitignore

Chaves de alternância ({a,b,c}) são uma extensão do shell (bash/zsh), não da sintaxe de glob usada pelo .gitignore. O Git trata {, , e } como caracteres literais — uma linha {a,b}.txt não ignora nem a.txt nem b.txt, só um arquivo chamado literalmente {a,b}.txt (raro na prática). Se você precisa de alternância real, escreva uma linha por padrão, ou use uma classe de caracteres ([ab].txt) quando os nomes diferirem em um único caractere.

rsync, tar e GitHub Actions

rsync --exclude/--include e tar --exclude usam a mesma base de glob (*, ** com a flag certa, ?, [...]), mas com regras próprias de ancoragem por barra inicial. O filtro paths: de um workflow do GitHub Actions também usa glob, mas roda contra a lista de arquivos alterados no push/PR, não a árvore inteira do repositório. Esta ferramenta cobre a gramática base — use-a para entender o comportamento de */**/?/classes antes de validar o caso exato na ferramenta real.

Perguntas frequentes