grep и ripgrep для поиска по коду: рекурсия, фильтры и коды завершения

Что это такое

grep печатает строки входных данных, соответствующие шаблону. Руководство GNU grep описывает -r для рекурсивного поиска, --include=glob и --exclude-dir=glob для ограничения читаемых файлов и каталогов, -F для фиксированных строк, -E для расширенных регулярных выражений, -P для Perl-совместимых, -w для целых слов, -l для вывода только имён файлов, -c для подсчёта, -n для номеров строк и -C num для строк контекста. Код завершения равен 0, если выбрана хотя бы одна строка, 1, если не выбрана ни одна, и 2, если произошла ошибка.

ripgrep (rg) — отдельный инструмент с похожим интерфейсом. Его руководство описывает «автоматическую фильтрацию»: получив каталог, он пропускает файлы, соответствующие glob-шаблонам из .gitignore, .ignore и .rgignore, скрытые файлы и каталоги, а также двоичные файлы (любой файл с байтом NUL) и не следует по символическим ссылкам. -u, -uu и -uuu последовательно отключают эти фильтры; --no-ignore, --hidden, --text и --follow делают это по отдельности. -g '*.rs' и -t rust ограничивают поиск по glob-шаблону или типу файла, а --files перечисляет то, что будет просматриваться.

Почему это важно

Пустой результат у этих двух инструментов означает разное. grep мог искать в результатах сборки и вендорных зависимостях, где нужное совпадение затерялось; ripgrep мог пропустить нужный файл, потому что он игнорируется Git или скрыт. Скрипты и агенты, выбирающие ветвь по условию «нет совпадений», должны знать, с каким случаем имеют дело, и должны трактовать код завершения 2 как «поиск завершился ошибкой», а не «не найдено».

Как применять

• Ищите буквальные строки с -F в обоих инструментах и заключайте шаблон в кавычки; используйте регулярные выражения только при необходимости.
• Явно ограничивайте область поиска: grep -rn --include='*.py' --exclude-dir=.venv pattern . или rg -n -t py pattern.
• Если ripgrep ничего не нашёл, повторите поиск с -uu, прежде чем заключать, что текста нет; rg --files показывает набор просматриваемых файлов.
• Передавайте списки файлов другим инструментам с -l; добавляйте -Z (grep) или -0 (ripgrep) вместе с xargs -0, если имена могут содержать пробелы.
• Используйте в ripgrep -S (умный учёт регистра), -C 3 для контекста, -U для многострочных шаблонов и --sort path, когда порядок вывода должен быть стабильным; руководство отмечает, что сортировка отключает параллелизм.

Подводные камни

Руководство grep указывает, что поведение выражений диапазона вроде [a-z] вне локали C не оговорено; используйте [[:lower:]] или запускайте с LC_ALL=C. -P — расширение GNU, которого может не быть в других реализациях grep. По умолчанию grep прекращает печать из файла, обнаружив байты NUL, и сообщает о совпадении в двоичном файле; -a принудительно включает текстовый режим. ripgrep прекращает поиск в файле, найденном обходом каталогов, при первом байте NUL; --binary продолжает поиск без печати двоичного содержимого, а -a трактует файл как текст. Порядок вывода ripgrep меняется от запуска к запуску, если не использовать --sort.