O ripgrep é uma ferramenta de linha de comando que procura texto em arquivos. Você informa um padrão e um diretório, e ele percorre a árvore em busca das correspondências. O comando é rg, e o resultado mostra o arquivo, a linha e o trecho encontrado.
A ferramenta foi escrita em Rust e usa vários núcleos para reduzir o tempo de varredura. Ela não mantém um índice: cada execução lê os arquivos. A velocidade vem da implementação e dos filtros aplicados antes da leitura.
Uma busca no projeto
O exemplo abaixo procura a palavra createServer nos arquivos do diretório atual:
rg -n "createServer"A opção -n mostra o número da linha. Sem ela, o resultado traz só o caminho e o trecho. Para limitar a busca a um tipo de arquivo, rg -t ts "createServer" considera apenas TypeScript. O comando rg --files lista os arquivos que seriam pesquisados, o que permite conferir os filtros.
A busca por padrão é sensível a maiúsculas e minúsculas. A opção -S ativa o modo inteligente: tudo em minúsculas ignora a caixa, e a presença de uma maiúscula distingue. A opção -i ignora a caixa em qualquer padrão.
O que fica de fora
O ripgrep respeita o .gitignore, o .ignore e as políticas globais do Git. Um arquivo gerado, uma pasta de dependências ou um segredo listado no ignore não aparecem no resultado. Arquivos ocultos também ficam fora, a menos que você informe --hidden.
Esse comportamento explica uma busca que não encontra o que você vê no editor. O editor pode mostrar arquivos ignorados ou abertos por outro caminho. Para incluir tudo, use rg --no-ignore --hidden "padrão". Para incluir um arquivo binário, --text força a leitura como texto.
Expressão regular e glob
O padrão é uma expressão regular, e rg "function\s+\w+" encontra declarações de função com o nome ao lado, enquanto a sintaxe do motor Rust não aceita referências retroativas. Quando o padrão depende delas, rg -P usa o PCRE2.
A opção -g filtra por glob, e rg -g "*.md" "webhook" procura apenas em Markdown. O filtro -g "!vendor/**" exclui uma pasta. A combinação com -l mostra apenas os nomes dos arquivos que contêm a correspondência, útil para alimentar outro comando.
Linhas ao redor e substituição
rg -C 2 "timeout" mostra duas linhas antes e duas depois de cada correspondência. As linhas ao redor ajudam a ler a configuração sem abrir o arquivo. A opção -A mostra só as linhas seguintes, e -B só as anteriores.
O ripgrep também substitui texto com -r. O comando rg -r "NOVO" "antigo" imprime o resultado com a troca, sem alterar os arquivos. A gravação exige outro passo, como redirecionar a saída ou usar uma ferramenta de edição. A revisão das alterações continua necessária.
Onde a ferramenta aparece
Editores e agentes de código usam o ripgrep para localizar arquivos antes de abrir o conteúdo. A busca por texto é mais direta que varrer a árvore com um script, e os filtros de ignore reduzem o ruído de dependências.
O limite está no tipo de consulta, porque o ripgrep encontra texto e não relações entre símbolos. Para ir de uma definição ao uso, uma linguagem com servidor de análise oferece uma navegação mais precisa, e as duas ferramentas convivem no mesmo terminal.
Dúvidas frequentes
Perguntas frequentes sobre Ripgrep
- O ripgrep precisa de um índice?
- Não. Ele percorre os arquivos a cada execução e aplica os filtros de inclusão e exclusão. A velocidade vem da implementação em Rust e do uso de vários núcleos, não de um índice mantido em disco.
- Por que um arquivo que existe não aparece no resultado?
- O ripgrep ignora arquivos listados no .gitignore, no .ignore e arquivos ocultos por padrão. Um arquivo binário também fica fora. As opções --hidden, --no-ignore e --text mudam esse comportamento.
- O ripgrep usa a mesma sintaxe de expressão regular do PCRE?
- Por padrão, usa o motor de expressão regular do Rust, que não aceita referências retroativas. A opção -P ativa o PCRE2 para os padrões que dependem desses recursos.
Para continuar
Recursos relacionados
Repositório
ripgrep: repositório e manual
Reúne o código, a instalação e a lista de opções da ferramenta, com a documentação do motor de busca.
Abrir recursoDocumentação
ripgrep: guia do usuário
Explica filtros, tipos de arquivo, linhas ao redor, substituição e o funcionamento das condições de exclusão.
Abrir recursoFerramenta
Debian: pacote ripgrep
Mostra o pacote disponível no Debian e a versão instalada pelo APT.
Abrir recursoAplicação na formação
Developer Workspace
No terminal do projeto, você usa o ripgrep para localizar uma função, uma configuração ou um texto antes de abrir o arquivo no editor.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.