Коротко о главном

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 станет понятнее, когда появится реальный сценарий использования.

Насколько публикация полезна?

Нажмите на звезду, чтобы оценить!

Средняя оценка 0 / 5. Количество оценок: 0

Оценок пока нет. Поставьте оценку первым.

Поделиться: Telegram ВКонтакте