ripgrep (rg): Busca Rapida em Codigo

2026-06-05 Tempo de leitura: Cerca de 9 min Dificuldade: Intermediate

O que e ripgrep (rg)?

Conclusao: ripgrep e uma alternativa extremamente rapida ao grep escrita em Rust. rg pattern busca no diretorio atual recursivamente e respeita .gitignore para pular ruido. O binario se chama rg.

ripgrep foi criado para buscar em bases de codigo. A tarefa "buscar em todo um diretorio" que voce costumava especificar como grep -rn se torna o comportamento padrao, sem flags extras necessarias.

rg TODO

Por que e mais rapido que o grep?

Conclusao: Tres fatores se somam: o motor de regex rapido do Rust, busca paralela entre arquivos e reducao do conjunto de busca antecipadamente via .gitignore e deteccao de binarios.

O motivo principal nao e apenas a linguagem de implementacao -- e que ripgrep busca em menos arquivos. grep -r percorre diligentemente .git/ e node_modules/, enquanto ripgrep os exclui do conjunto de candidatos desde o inicio.

Como instalar?

Conclusao: No Ubuntu/Debian use apt install ripgrep. Se a versao 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 instalacao:

rg --version

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

Como executar uma busca basica?

Conclusao: rg pattern e a forma base. Use -i para ignorar maiusculas/minusculas, -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 padrao os resultados mostram o nome do arquivo, numero 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?

Conclusao: Use -t TIPO para um grupo de linguagem/extensao, e -g 'glob' para um padrao arbitrario. Execute rg --type-list para ver os tipos disponiveis.

# 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 disponiveis:

rg --type-list | head

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

Como mostrar linhas ao redor de uma correspondencia?

Conclusao: Use -A N (apos), -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 saida:

# 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

Conclusao: Use --hidden para arquivos ocultos, -u (--unrestricted) para ignorar .gitignore, -uu para ambos e -uuu para buscar tudo incluindo binarios.

ripgrep padrao faz uma busca "limpa", mas as vezes voce 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?

Conclusao: -r visualiza a saida substituida. Ele nao 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 e apenas para confirmacao. O padrao seguro e revisar o resultado, depois reescrever com sed.

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

Referencia rapida para migrar do grep

Conclusao: Na maioria dos casos voce pode trocar grep -rn por rg e funciona. Aprenda filtragem por tipo e exibicao de contexto e suas buscas diarias 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'