Коротко о главном
Ripgrep написан на Rust и оптимизирован для больших репозиториев. Он автоматически учитывает .gitignore, не заходит в бинарные файлы и умеет искать по типам файлов. В статье разберём базовый поиск, фильтры, контекст и настройку через файл конфигурации. Примеры рассчитаны на Linux и не зависят от конкретного дистрибутива.
Скорость ripgrep заметна на больших деревьях исходников и логах. Разумные исключения по умолчанию уменьшают шум от служебных каталогов. Гибкие фильтры позволяют искать только в нужных расширениях и путях. В результате разработчик быстрее находит определения, ошибки и упоминания.
ripgrep — инструмент, который стоит освоить, если вы регулярно работаете в Linux. Ниже — путь от установки до уверенной повседневной работы: без предположений, что всё уже настроено само.
Зачем нужен ripgrep
ripgrep решает вполне конкретные задачи: ripgrep — быстрый рекурсивный поиск по текстовым файлам с поддержкой регулярных выражений и правил игнорирования. Он заменяет связку grep и find в большинстве задач разработчика. Важно не превращать инструмент в самоцель — если задача проще решается штатными средствами системы, начните с них.
Установка
В Debian, Ubuntu и Linux Mint используется пакетный менеджер APT:
sudo apt install ripgrep
В Fedora и RHEL-совместимых системах пакет ставится через DNF:
sudo dnf install ripgrep
В Arch Linux и производных пакет доступен в официальных репозиториях:
sudo pacman -S ripgrep
Пошаговая настройка
После установки переходите к базовому сценарию. Команды ниже выполняйте от пользователя с достаточными правами, но не запускайте всё под root без необходимости.
1. Выполните простой поиск
По умолчанию ripgrep рекурсивно обходит текущий каталог и печатает строки с совпадениями. Флаг -n добавляет номера строк, что удобно для перехода в редакторе. Проверьте работу на каталоге с исходниками.
rg -n 'TODO' .
2. Ограничьте поиск типами файлов
Флаг -t выбирает зарегистрированный тип файлов, например python или rust. Список доступных типов можно посмотреть отдельно. Это быстрее и точнее, чем вручную перечислять расширения.
rg -t py 'requests' .
rg --type-list | head -n 20
3. Добавьте glob-фильтры и контекст
Параметр -g включает или исключает пути по шаблону, а -C показывает строки вокруг совпадения. Несколько фильтров применяются последовательно. Так можно искать только в документации и не отвлекаться на changelog.
rg -g '*.md' -g '!CHANGELOG*' 'установка' .
rg -C 2 -n 'timeout' src/
4. Посмотрите замену без изменения файлов
Флаг -r подставляет текст в вывод, но не перезаписывает файлы. Это безопасный способ проверить регулярное выражение перед массовой правкой. Для реального изменения используйте редактор или отдельную команду с резервной копией.
rg -n 'localhost' -r '127.0.0.1' config/
5. Подключите файл настроек
Переменная RIPGREP_CONFIG_PATH указывает на файл с постоянными параметрами. Блок из поля config включает умный регистр, скрытые файлы и исключения для Git и node_modules. После экспорта переменной проверьте статистику поиска.
export RIPGREP_CONFIG_PATH="$HOME/.ripgreprc"
rg --stats 'panic' src/
Базовая конфигурация
Начните с минимального рабочего варианта. Не копируйте большой конфиг целиком: добавляйте параметры по одному и проверяйте результат после каждого изменения.
# ~/.ripgreprc
--smart-case
--hidden
--glob=!.git/*
--glob=!node_modules/*
--max-columns=200
Практические советы
Эти рекомендации проверены на повседневных задачах. Начните с тех, которые закрывают вашу текущую боль, а не со всего списка сразу.
Совет 1. Используйте -F для поиска буквальной строки, если в запросе есть симво
Используйте -F для поиска буквальной строки, если в запросе есть символы регулярных выражений.
Совет 2. Флаг -l печатает только имена файлов, а -c считает совпадения по каждо
Флаг -l печатает только имена файлов, а -c считает совпадения по каждому файлу.
Совет 3. Команда rg —files удобна для быстрого списка файлов с учётом правил и
Команда rg —files удобна для быстрого списка файлов с учётом правил игнорирования.
Совет 4. Флаг -U включает многострочный режим и позволяет искать конструкции, р
Флаг -U включает многострочный режим и позволяет искать конструкции, разнесённые по строкам.
Совет 5. Проверяйте, не исключён ли каталог через .gitignore или глобальный ign
Проверяйте, не исключён ли каталог через .gitignore или глобальный ignore-файл, если совпадений неожиданно нет.
Практический сценарий
Представьте типовую задачу: нужно развернуть ripgrep на одной машине, проверить работу и передать доступ коллеге. Начните с чистой системы или снапшота, чтобы результат был воспроизводим. Запишите все команды в отдельный файл — это одновременно шпаргалка и черновик будущей автоматизации.
Дальше действуйте короткими шагами: установка, минимальная конфигурация, проверка, затем расширение. После каждого шага фиксируйте, что именно изменилось и как это проверить. Такой журнал экономит время, когда через месяц понадобится повторить настройку на другом сервере или объяснить её коллеге.
Порядок работ для этого сценария выглядит так:
- Выполните простой поиск
- Ограничьте поиск типами файлов
- Добавьте glob-фильтры и контекст
- Посмотрите замену без изменения файлов
- Подключите файл настроек
Отдельно продумайте, что произойдёт при сбое. Для ripgrep важно заранее знать, где хранятся данные, как их скопировать и сколько времени займёт восстановление. Если ответа нет, не двигайтесь дальше: сначала закройте этот пробел, потом добавляйте новые возможности.
Типичные ошибки
Ниже — сбои, которые встречаются чаще всего. Перед исправлением сохраните текущие конфиги и запишите, какие изменения вносите: так проще откатиться.
1. Команда rg не найдена.
Установите пакет ripgrep для своего дистрибутива и проверьте PATH. Бинарный файл называется rg, а не ripgrep.
2. Поиск не находит файл, который точно существует.
Файл может быть скрыт или исключён правилами ignore. Проверьте с флагами -H и —no-ignore, затем уберите лишнее исключение.
3. Регулярное выражение вызывает ошибку синтаксиса.
Проверьте экранирование в оболочке и используйте -F для буквального поиска. Сложный шаблон удобнее сначала протестировать на одной строке.
4. Вывод обрезан или содержит слишком длинные строки.
Настройте —max-columns и —max-columns-preview либо временно отключите ограничение. Это особенно важно для минифицированных файлов.
Что проверить перед вводом в работу
Перед тем как считать настройку завершённой, пройдитесь по короткому списку. Он не заменяет полноценный аудит, но отсекает большинство очевидных проблем.
Чек-лист
- Версия ripgrep зафиксирована, а обновления не применяются вслепую.
- Есть резервная копия конфигурации и данных, восстановление проверено.
- Доступ ограничен нужными пользователями и сетями, лишние порты закрыты.
- Логи и метрики собираются, понятно, куда смотреть при сбое.
- Изменения описаны в документации и могут быть повторены на другой машине.
- Есть план отката и понятный критерий, по которому вы решите его применить.
Если какой-то пункт вызывает затруднение, это сигнал вернуться к соответствующему разделу, а не откладывать проверку. Настройка, которую нельзя повторить, плохо работает не только у коллег, но и у вас самих через полгода.
Итог
ripgrep — это не «поставил и забыл». Рабочая конфигурация складывается из понимания задачи, аккуратной установки и проверки результата. Начните с базового сценария, затем добавляйте только те возможности, которые действительно используете.