ripgrep (rg): Busca Rápida em Código

2026-06-05 Tempo de leitura: Cerca de 9 min Dificuldade: Intermediário+

O que é ripgrep (rg)?

Conclusão: ripgrep é uma alternativa extremamente rápida ao grep escrita em Rust. rg pattern busca no diretório atual recursivamente e respeita .gitignore para pular ruído. O binário se chama rg.

ripgrep foi criado para buscar em bases de código. A tarefa "buscar em todo um diretório" que você costumava especificar como grep -rn se torna o comportamento padrão, sem flags extras necessárias.

rg TODO

Por que é mais rápido que o grep?

Conclusão: Três fatores se somam: o motor de regex rápido do Rust, busca paralela entre arquivos e redução do conjunto de busca antecipadamente via .gitignore e detecção de binários.

O motivo principal não é apenas a linguagem de implementação -- é que ripgrep busca em menos arquivos. grep -r percorre diligentemente .git/ e node_modules/, enquanto ripgrep os exclui do conjunto de candidatos desde o início.

Como instalar?

Conclusão: No Ubuntu/Debian use apt install ripgrep. Se a versão empacotada for antiga, pegue o .deb do GitHub Releases ou use cargo install ripgrep.

# Ubuntu / Debian
sudo apt install ripgrep

# Fedora / familia RHEL
sudo dnf install ripgrep

# macOS (Homebrew)
brew install ripgrep

# Se voce tem um toolchain Rust
cargo install ripgrep

Verifique a instalação:

rg --version

ripgrep 14.1.0
-SIMD -AVX (compiled)
+SIMD +AVX (runtime)

Como executar uma busca básica?

Conclusão: rg pattern é a forma base. Use -i para ignorar maiúsculas/minúsculas, -w para corresponder palavras inteiras e -F para buscar uma string fixa (desabilitando regex).

# Buscar na arvore atual por "config"
rg config

# Ignorar maiusculas/minusculas
rg -i config

# Palavra inteira ("configure" nao vai corresponder)
rg -w config

# Tratar como string literal, nao regex
rg -F "a.b.c"

Por padrão os resultados mostram o nome do arquivo, número da linha e a linha correspondente, tudo colorizado.

src/main.rs
12:    let config = load_config();
48:    config.reload();

Como filtrar por tipo de arquivo?

Conclusão: Use -t TIPO para um grupo de linguagem/extensão, e -g 'glob' para um padrão arbitrário. Execute rg --type-list para ver os tipos disponíveis.

# Buscar apenas em arquivos Python
rg -t py "import requests"

# Excluir JavaScript / TypeScript
rg -T js "function"

# Alvejar uma extensao diretamente com um glob
rg -g '*.md' "TODO"

# Multiplos globs (! exclui)
rg -g '*.rs' -g '!target/*' "unsafe"

Listar os tipos disponíveis:

rg --type-list | head

agda: *.agda, *.lagda
asciidoc: *.adoc, *.asc, *.asciidoc
asm: *.S, *.a51, *.asm, *.s
...

Como mostrar linhas ao redor de uma correspondência?

Conclusão: Use -A N (após), -B N (antes) e -C N (ambos) para imprimir linhas de contexto. Essencial ao ler ao redor de um erro em logs.

# Tambem mostrar 3 linhas apos a correspondencia
rg -A 3 "panic"

# Tambem mostrar 2 linhas antes da correspondencia
rg -B 2 "Exception"

# 3 linhas de cada lado (o mais usado)
rg -C 3 "Traceback"

Outros controles de saída:

# Apenas os nomes dos arquivos correspondentes (quando voce quer uma lista)
rg -l "deprecated"

# Apenas a contagem de correspondencias
rg -c "TODO"

# Extrair apenas a parte correspondente
rg -o 'https?://[^ ]+'

Quero buscar em arquivos ignorados pelo .gitignore

Conclusão: Use --hidden para arquivos ocultos, -u (--unrestricted) para ignorar .gitignore, -uu para ambos e -uuu para buscar tudo incluindo binários.

ripgrep padrão faz uma busca "limpa", mas às vezes você precisa olhar dentro de logs, .env ou node_modules. Remova os filtros em etapas.

# Incluir arquivos ocultos (.env, etc.)
rg --hidden "API_KEY"

# Ignorar .gitignore (buscar node_modules e similares)
rg -u "lodash"

# Arquivos ocultos + ignorar .gitignore
rg -uu "TODO"

# Tudo, incluindo binarios
rg -uuu "magic_bytes"

Ele pode substituir texto?

Conclusão: -r visualiza a saída substituída. Ele não modifica arquivos (apenas stdout). Para reescrever arquivos reais, combine com algo como sed -i.

# Mostrar o resultado de substituir foo por bar (arquivos inalterados)
rg 'foo' -r 'bar'

# Visualizacao de substituicao usando grupos de captura
rg '(\w+)@(\w+)' -r '$2.$1'

rg -r é apenas para confirmação. O padrão seguro é revisar o resultado, depois reescrever com sed.

# Confirmar alvos e substituicoes com rg primeiro, depois
sed -i 's/foo/bar/g' $(rg -l 'foo')

Referência rápida para migrar do grep

Conclusão: Na maioria dos casos você pode trocar grep -rn por rg e funciona. Aprenda filtragem por tipo e exibição de contexto e suas buscas diárias vivem inteiramente no ripgrep.

# Listar todo TODO no projeto
rg -n 'TODO|FIXME'

# Encontrar sites de erro apenas em Python, com contexto
rg -t py -C 3 'raise '

# Verificar segredos vazados, incluindo arquivos ocultos
rg --hidden -g '!.git/*' 'API_KEY|SECRET'