Digite para filtrar os verbetes do Glossário.

    Ferramentas de desenvolvimento · Developer Workspace

    O que é Ripgrep?

    O ripgrep procura texto em arquivos de um diretório, com expressão regular e respeito às políticas do Git. Ele varre o projeto sem manter índice.

    Também chamado de: rg, ripgrep

    StayCloudVPS Agêntica

    O mesmo ambiente do SetupVibe, agora numa VPS

    Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

    Criar minha VPS na StayCloud

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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:

    Terminal
    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

    Aplicaçã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
    Capa da Formação Developer Workspace

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano