grep e ripgrep na busca em código: recursão, filtros e códigos de saída

O que é

O grep imprime as linhas da entrada que correspondem a um padrão. O manual do GNU grep documenta -r para busca recursiva, --include=glob e --exclude-dir=glob para restringir quais arquivos e diretórios são lidos, -F para strings fixas, -E para expressões regulares estendidas, -P para expressões compatíveis com Perl, -w para palavras inteiras, -l para exibir apenas os nomes dos arquivos, -c para contagens, -n para números de linha e -C num para linhas de contexto. O código de saída é 0 se alguma linha foi selecionada, 1 se nenhuma foi e 2 se ocorreu um erro.

O ripgrep (rg) é uma ferramenta independente, com interface semelhante. O guia dele descreve uma "filtragem automática": ao receber um diretório, ele ignora arquivos que correspondam a globs de .gitignore, .ignore e .rgignore, arquivos e diretórios ocultos e arquivos binários (qualquer arquivo que contenha um byte NUL), e não segue links simbólicos. -u, -uu e -uuu desativam esses filtros de forma progressiva; --no-ignore, --hidden, --text e --follow desativam cada um individualmente. -g '*.rs' e -t rust restringem a busca por glob ou por tipo de arquivo, e --files lista o que seria pesquisado.

Por que importa

Um resultado vazio tem significados diferentes nas duas ferramentas. O grep pode ter varrido a saída de build e dependências vendorizadas, e o resultado procurado ficou perdido no meio; o ripgrep pode ter ignorado o arquivo desejado por ele estar no gitignore ou oculto. Scripts e agentes que tomam decisões com base em "nenhuma correspondência" precisam saber em qual dos casos estão e devem tratar o código de saída 2 como "a busca falhou", não como "não encontrado".

Como aplicar

• Busque strings literais com -F nas duas ferramentas e coloque o padrão entre aspas; use expressões regulares apenas quando necessário.
• Delimite o escopo de forma explícita: grep -rn --include='*.py' --exclude-dir=.venv pattern . ou rg -n -t py pattern.
• Quando o ripgrep não encontrar nada, tente de novo com -uu antes de concluir que o texto não existe; rg --files mostra o conjunto de arquivos pesquisados.
• Passe listas de arquivos a outras ferramentas com -l; acrescente -Z (grep) ou -0 (ripgrep) junto com xargs -0 quando os nomes puderem conter espaços.
• Use -S do ripgrep (smart case), -C 3 para contexto, -U para padrões de várias linhas e --sort path quando a ordem da saída precisar ser estável; o guia observa que a ordenação desativa o paralelismo.

Armadilhas

O manual do grep afirma que expressões de intervalo como [a-z] não são especificadas fora do locale C; use [[:lower:]] ou execute com LC_ALL=C. -P é uma extensão do GNU que outras implementações de grep podem não ter. Por padrão, o grep para de imprimir o conteúdo de um arquivo ao encontrar bytes NUL e informa uma correspondência em arquivo binário; -a força o tratamento como texto. O ripgrep interrompe a busca em um arquivo alcançado por percurso de diretório no primeiro byte NUL; --binary continua a busca nele sem imprimir conteúdo binário, e -a o trata como texto. A ordem da saída do ripgrep varia entre execuções, a menos que se use --sort.