Como encontrar um arquivo específico pelo texto dele no Linux

O comando#

grep -rnw . \
  --exclude-dir=node_modules \
  --exclude-dir=.next \
  --exclude-dir=dist \
  -e 'Texto a ser procurado'

Explicando cada parte#

• grep — o programa responsável por buscar padrões de texto dentro de arquivos.
• -r (recursive) — faz a busca de forma recursiva, entrando em todas as subpastas a partir do diretório informado, em vez de olhar só os arquivos do nível atual.
• -n (line number) — mostra o número da linha onde o texto foi encontrado, o que ajuda a localizar o trecho exato dentro do arquivo.
• -w (word) — garante que o grep procure pela palavra exata, evitando que ele retorne resultados onde o termo aparece apenas como parte de outra palavra (por exemplo, buscar por "user" não vai trazer "username").
• . — indica que a busca deve começar no diretório atual.
• --exclude-dir=node_modules, --exclude-dir=.next, --exclude-dir=dist — ignoram pastas que normalmente contêm milhares de arquivos gerados automaticamente (dependências, builds, cache), evitando resultados irrelevantes e deixando a busca muito mais rápida.
• -e 'Texto a ser procurado' — define o padrão (texto) que será buscado. O uso do -e é útil principalmente quando você quer combinar múltiplos padrões de busca no mesmo comando.

Cenário de uso#

Imagine que você está mexendo em um projeto Next.js (como o de um site, por exemplo) e precisa alterar um texto que aparece em algum lugar da interface — só que você não sabe em qual componente ou arquivo esse texto está definido. Em vez de abrir arquivo por arquivo tentando adivinhar, basta rodar:

grep -rnw . \
  --exclude-dir=node_modules \
  --exclude-dir=.next \
  --exclude-dir=dist \
  -e 'Entre em contato'

O terminal vai retornar algo como:

./src/components/Footer.tsx:42:  <button>Entre em contato</button>

Com isso você já sabe exatamente o arquivo (Footer.tsx) e a linha (42) onde o texto está, sem precisar vasculhar o projeto manualmente.

Dica extra#

Se você quiser ignorar diferenças entre maiúsculas e minúsculas na busca, adicione a flag -i:

grep -rniw . \
  --exclude-dir=node_modules \
  --exclude-dir=.next \
  --exclude-dir=dist \
  -e 'texto a ser procurado'

Isso é útil quando você não tem certeza de como o texto foi escrito no código-fonte.