Коротко о главном
Ripgrep написан на Rust и оптимизирован для больших репозиториев. Он автоматически учитывает .gitignore, не заходит в бинарные файлы и умеет искать по типам файлов. В статье разберём базовый поиск, фильтры, контекст и настройку через файл конфигурации. Примеры рассчитаны на Linux и не зависят от конкретного дистрибутива.
Скорость ripgrep заметна на больших деревьях исходников и логах. Разумные исключения по умолчанию уменьшают шум от служебных каталогов. Гибкие фильтры позволяют искать только в нужных расширениях и путях. В результате разработчик быстрее находит определения, ошибки и упоминания.
Этот материал — быстрый старт по ripgrep. За 15 минут вы получите рабочую конфигурацию и поймёте, куда смотреть дальше.
Установка
В Debian, Ubuntu и Linux Mint используется пакетный менеджер APT:
sudo apt install ripgrep
В Fedora и RHEL-совместимых системах пакет ставится через DNF:
sudo dnf install ripgrep
В Arch Linux и производных пакет доступен в официальных репозиториях:
sudo pacman -S ripgrep
Минимальная настройка
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/
Минимальный конфиг
Начните с минимального рабочего варианта. Не копируйте большой конфиг целиком: добавляйте параметры по одному и проверяйте результат после каждого изменения.
# ~/.ripgreprc
--smart-case
--hidden
--glob=!.git/*
--glob=!node_modules/*
--max-columns=200
Шпаргалка по командам
- Выполните простой поиск: rg -n ‘TODO’ .
- Ограничьте поиск типами файлов: rg -t py ‘requests’ .
- Добавьте glob-фильтры и контекст: rg -g ‘*.md’ -g ‘!CHANGELOG*’ ‘установка’ .
- Посмотрите замену без изменения файлов: rg -n ‘localhost’ -r ‘127.0.0.1’ config/
- Подключите файл настроек: export RIPGREP_CONFIG_PATH=»$HOME/.ripgreprc»
Практические советы
Эти рекомендации проверены на повседневных задачах. Начните с тех, которые закрывают вашу текущую боль, а не со всего списка сразу.
Совет 1. Используйте -F для поиска буквальной строки, если в запросе есть симво
Используйте -F для поиска буквальной строки, если в запросе есть символы регулярных выражений.
Совет 2. Флаг -l печатает только имена файлов, а -c считает совпадения по каждо
Флаг -l печатает только имена файлов, а -c считает совпадения по каждому файлу.
Совет 3. Команда rg —files удобна для быстрого списка файлов с учётом правил и
Команда rg —files удобна для быстрого списка файлов с учётом правил игнорирования.
Совет 4. Флаг -U включает многострочный режим и позволяет искать конструкции, р
Флаг -U включает многострочный режим и позволяет искать конструкции, разнесённые по строкам.
Что дальше
Быстрый старт не означает «настроить навсегда». Когда базовый сценарий заработает, вернитесь к конфигурации и проверьте, что она переживёт перезагрузку: файлы на месте, служба включена в автозагрузку, путь к данным не зависит от текущего каталога.
Дальше имеет смысл разобраться с резервной копией и журналами ripgrep. Это не самая заметная часть работы, но именно она превращает эксперимент в инструмент, которым можно пользоваться каждый день.
Чек-лист
- Команды из шпаргалки выполняются без ошибок после перезагрузки.
- Пароли и токены не хранятся в истории команд и конфигурации в открытом виде.
- Понятно, где смотреть логи и что считать признаком проблемы.
- Есть копия конфигурации, которую можно восстановить.
Короткие ответы на частые вопросы
Нужно ли запускать всё от root?
Нет. Права root нужны для установки пакетов и изменения системных файлов, но сама программа и её данные должны принадлежать отдельному пользователю. Постоянная работа под root превращает любую ошибку в критическую.
Что делать, если после перезагрузки ничего не работает?
Сначала проверьте, включена ли служба в автозагрузку и не изменился ли путь к конфигурации. Посмотрите журнал текущей загрузки: он почти всегда указывает на отсутствующий файл, неверные права или занятый порт.
Как обновлять без сюрпризов?
Читайте примечания к версии, делайте резервную копию конфигурации и проверяйте обновление на тестовом стенде. Не обновляйтесь в пятницу вечером перед выходными: время на откат должно быть частью плана.
Использование в скриптах
При встраивании ripgrep в скрипт включайте строгий режим и проверяйте коды возврата: иначе сбой пройдёт незамеченным.
#!/usr/bin/env bash
set -euo pipefail
if ! command -v ripgrep >/dev/null 2>&1; then
echo "ripgrep не установлен" >&2
exit 1
fi
ripgrep --version 2>/dev/null || true
Вывод направляйте в файл, а в журнал пишите только результат: так проще отлаживать на сервере.
ripgrep args > output.log 2>&1
tail -20 output.log
echo "exit: $?"
Итог
Этого достаточно, чтобы начать. Дальше углубляйтесь по мере задач: документация ripgrep станет понятнее, когда появится реальный сценарий использования.