Коротко о главном
fzf принимает строки на стандартный ввод и позволяет быстро выбрать нужную с помощью нечёткого поиска. Его используют для открытия файлов, переключения веток, поиска по истории и запуска команд. В статье настроим интеграцию с оболочкой, предпросмотр и множественный выбор. Примеры работают в Bash, Zsh и Fish на любом из популярных дистрибутивов.
Вместо запоминания точного пути достаточно ввести несколько символов. Нечёткий поиск устойчив к опечаткам и порядку символов. fzf экономит время в задачах, где обычный Tab слишком медленный или неудобный. При этом инструмент не требует базы данных и работает с любым текстовым выводом.
Этот материал — быстрый старт по fzf. За 15 минут вы получите рабочую конфигурацию и поймёте, куда смотреть дальше.
Установка
В Debian, Ubuntu и Linux Mint используется пакетный менеджер APT:
sudo apt install fzf
В Fedora и RHEL-совместимых системах пакет ставится через DNF:
sudo dnf install fzf
В Arch Linux и производных пакет доступен в официальных репозиториях:
sudo pacman -S fzf
Минимальная настройка
1. Отфильтруйте простой список
Передайте fzf любой поток строк, и он откроет интерактивное меню. Начните вводить часть строки, чтобы сузить выбор. Нажмите Enter, чтобы вывести выбранный элемент в стандартный вывод.
ls | fzf
2. Включите интеграцию с оболочкой
Современный fzf умеет генерировать код интеграции для Bash, Zsh и Fish. Подключите его в конфигурации оболочки, чтобы получить сочетания Ctrl+T и Alt+C. После изменения откройте новый терминал или загрузите конфигурацию заново.
fzf --version
eval "$(fzf --bash)"
3. Добавьте предпросмотр файла
Параметр —preview выполняет команду для текущей строки и показывает результат справа или снизу. Символ {} подставляет выбранный путь. Для больших файлов ограничьте вывод, чтобы предпросмотр оставался быстрым.
fzf --preview 'head -n 40 {}'
4. Выберите несколько элементов
Флаг -m разрешает отметить несколько строк клавишей Tab. После подтверждения выбранные элементы выводятся по одному в строке. Передавайте их в xargs с нулевым разделителем, если возможны пробелы.
printf '%s\n' src/a.c src/b.c | fzf -m | xargs -r wc -l
Минимальный конфиг
Начните с минимального рабочего варианта. Не копируйте большой конфиг целиком: добавляйте параметры по одному и проверяйте результат после каждого изменения.
# ~/.bashrc
export FZF_DEFAULT_COMMAND='fd --type f --hidden --exclude .git'
export FZF_DEFAULT_OPTS='--height 40% --layout=reverse --border'
export FZF_CTRL_T_COMMAND="$FZF_DEFAULT_COMMAND"
Шпаргалка по командам
- Отфильтруйте простой список: ls | fzf
- Включите интеграцию с оболочкой: fzf —version
- Добавьте предпросмотр файла: fzf —preview ‘head -n 40 {}’
- Выберите несколько элементов: printf ‘%s\n’ src/a.c src/b.c | fzf -m | xargs -r wc -l
- Переключите ветку Git через меню: git branch —format=’%(refname:short)’ | fzf | xargs -r git switch
Практические советы
Эти рекомендации проверены на повседневных задачах. Начните с тех, которые закрывают вашу текущую боль, а не со всего списка сразу.
Совет 1. Ctrl+T вставляет выбранный файл в командную строку, а Alt+C позволяет
Ctrl+T вставляет выбранный файл в командную строку, а Alt+C позволяет перейти в выбранный каталог.
Совет 2. Храните постоянные параметры в FZF_DEFAULT_OPTS, чтобы не повторять оф
Храните постоянные параметры в FZF_DEFAULT_OPTS, чтобы не повторять оформление и поведение в каждой команде.
Совет 3. Используйте —scheme=path при выборе путей: алгоритм учитывает структу
Используйте —scheme=path при выборе путей: алгоритм учитывает структуру каталогов.
Совет 4. Для предпросмотра с подсветкой применяйте bat, но в Debian помните об
Для предпросмотра с подсветкой применяйте bat, но в Debian помните об имени batcat.
Что дальше
Быстрый старт не означает «настроить навсегда». Когда базовый сценарий заработает, вернитесь к конфигурации и проверьте, что она переживёт перезагрузку: файлы на месте, служба включена в автозагрузку, путь к данным не зависит от текущего каталога.
Дальше имеет смысл разобраться с резервной копией и журналами fzf. Это не самая заметная часть работы, но именно она превращает эксперимент в инструмент, которым можно пользоваться каждый день.
Чек-лист
- Команды из шпаргалки выполняются без ошибок после перезагрузки.
- Пароли и токены не хранятся в истории команд и конфигурации в открытом виде.
- Понятно, где смотреть логи и что считать признаком проблемы.
- Есть копия конфигурации, которую можно восстановить.
Короткие ответы на частые вопросы
Нужно ли запускать всё от root?
Нет. Права root нужны для установки пакетов и изменения системных файлов, но сама программа и её данные должны принадлежать отдельному пользователю. Постоянная работа под root превращает любую ошибку в критическую.
Что делать, если после перезагрузки ничего не работает?
Сначала проверьте, включена ли служба в автозагрузку и не изменился ли путь к конфигурации. Посмотрите журнал текущей загрузки: он почти всегда указывает на отсутствующий файл, неверные права или занятый порт.
Как обновлять без сюрпризов?
Читайте примечания к версии, делайте резервную копию конфигурации и проверяйте обновление на тестовом стенде. Не обновляйтесь в пятницу вечером перед выходными: время на откат должно быть частью плана.
Итог
Этого достаточно, чтобы начать. Дальше углубляйтесь по мере задач: документация fzf станет понятнее, когда появится реальный сценарий использования.