grep y ripgrep para buscar código: recursión, filtros y códigos de salida

Qué es

grep imprime las líneas de su entrada que coinciden con un patrón. El manual de GNU grep documenta -r para la búsqueda recursiva, --include=glob y --exclude-dir=glob para restringir qué archivos y directorios se leen, -F para cadenas fijas, -E para expresiones regulares extendidas, -P para las compatibles con Perl, -w para palabras completas, -l para solo nombres de archivo, -c para recuentos, -n para números de línea y -C num para líneas de contexto. El estado de salida es 0 si se seleccionó alguna línea, 1 si no se seleccionó ninguna, y 2 si ocurrió un error.

ripgrep (rg) es una herramienta aparte con una interfaz similar. Su guía describe el «filtrado automático»: cuando se le da un directorio, omite los archivos que coinciden con los patrones glob de .gitignore, .ignore y .rgignore, los archivos y directorios ocultos, y los archivos binarios (cualquier archivo que contenga un byte NUL), y no sigue enlaces simbólicos. -u, -uu y -uuu desactivan progresivamente esos filtros; --no-ignore, --hidden, --text y --follow lo hacen de forma individual. -g '*.rs' y -t rust restringen por glob o por tipo de archivo, y --files lista lo que se buscaría.

Por qué importa

Un resultado vacío significa cosas distintas en las dos herramientas. grep puede haber buscado en la salida de compilación y en dependencias empaquetadas (vendored) y haber enterrado la coincidencia; ripgrep puede haber omitido el archivo buscado porque está ignorado por git o está oculto. Los scripts y los agentes que se ramifican según «sin coincidencias» deben saber en cuál de los dos casos están, y deben tratar el estado de salida 2 como «la búsqueda falló», no como «no se encontró».

Cómo aplicarlo

• Buscar cadenas literales con -F en ambas herramientas y entrecomillar el patrón; usar expresiones regulares solo cuando haga falta.
• Restringir el alcance explícitamente: grep -rn --include='*.py' --exclude-dir=.venv pattern . o rg -n -t py pattern.
• Cuando ripgrep no encuentra nada, reintentar con -uu antes de concluir que el texto no existe; rg --files muestra el conjunto buscado.
• Pasar listas de archivos a otras herramientas con -l; añadir -Z (grep) o -0 (ripgrep) junto con xargs -0 cuando los nombres puedan contener espacios.
• Usar -S de ripgrep (mayúsculas inteligentes, smart case), -C 3 para contexto, -U para patrones multilínea y --sort path cuando el orden de salida deba ser estable; la guía señala que ordenar desactiva el paralelismo.

Trampas

El manual de grep establece que las expresiones de rango como [a-z] no están especificadas fuera de la configuración regional C; usar [[:lower:]] o ejecutar con LC_ALL=C. -P es una extensión de GNU que otras implementaciones de grep pueden no tener. Por defecto, grep deja de imprimir desde un archivo en cuanto ve bytes NUL y reporta una coincidencia de archivo binario; -a fuerza el tratamiento como texto. ripgrep detiene la búsqueda en un archivo alcanzado por recorrido de directorios en el primer byte NUL; --binary sigue buscando en él sin imprimir contenido binario, -a lo trata como texto. El orden de salida de ripgrep varía entre ejecuciones a menos que se use --sort.