Коротко о главном
fzf принимает строки на стандартный ввод и позволяет быстро выбрать нужную с помощью нечёткого поиска. Его используют для открытия файлов, переключения веток, поиска по истории и запуска команд. В статье настроим интеграцию с оболочкой, предпросмотр и множественный выбор. Примеры работают в Bash, Zsh и Fish на любом из популярных дистрибутивов.
Вместо запоминания точного пути достаточно ввести несколько символов. Нечёткий поиск устойчив к опечаткам и порядку символов. fzf экономит время в задачах, где обычный Tab слишком медленный или неудобный. При этом инструмент не требует базы данных и работает с любым текстовым выводом.
fzf — инструмент, который стоит освоить, если вы регулярно работаете в Linux. Ниже — путь от установки до уверенной повседневной работы: без предположений, что всё уже настроено само.
Зачем нужен fzf
fzf решает вполне конкретные задачи: fzf — интерактивный нечёткий фильтр для списков, файлов, истории и веток Git. Он превращает вывод любой команды в удобное меню выбора. Важно не превращать инструмент в самоцель — если задача проще решается штатными средствами системы, начните с них.
Установка
В Debian, Ubuntu и Linux Mint используется пакетный менеджер APT:
sudo apt install fzf
В Fedora и RHEL-совместимых системах пакет ставится через DNF:
sudo dnf install fzf
В Arch Linux и производных пакет доступен в официальных репозиториях:
sudo pacman -S fzf
Пошаговая настройка
После установки переходите к базовому сценарию. Команды ниже выполняйте от пользователя с достаточными правами, но не запускайте всё под root без необходимости.
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
5. Переключите ветку Git через меню
fzf удобно применять к списку локальных веток. Команда git branch —format выводит только короткие имена без лишних символов. Выбранное имя передаётся в git switch.
git branch --format='%(refname:short)' | fzf | xargs -r git switch
Базовая конфигурация
Начните с минимального рабочего варианта. Не копируйте большой конфиг целиком: добавляйте параметры по одному и проверяйте результат после каждого изменения.
# ~/.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"
Практические советы
Эти рекомендации проверены на повседневных задачах. Начните с тех, которые закрывают вашу текущую боль, а не со всего списка сразу.
Совет 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.
Совет 5. Флаг —exact включает точное совпадение подстроки и помогает в предска
Флаг —exact включает точное совпадение подстроки и помогает в предсказуемых списках.
Практический сценарий
Представьте типовую задачу: нужно развернуть fzf на одной машине, проверить работу и передать доступ коллеге. Начните с чистой системы или снапшота, чтобы результат был воспроизводим. Запишите все команды в отдельный файл — это одновременно шпаргалка и черновик будущей автоматизации.
Дальше действуйте короткими шагами: установка, минимальная конфигурация, проверка, затем расширение. После каждого шага фиксируйте, что именно изменилось и как это проверить. Такой журнал экономит время, когда через месяц понадобится повторить настройку на другом сервере или объяснить её коллеге.
Порядок работ для этого сценария выглядит так:
- Отфильтруйте простой список
- Включите интеграцию с оболочкой
- Добавьте предпросмотр файла
- Выберите несколько элементов
- Переключите ветку Git через меню
Отдельно продумайте, что произойдёт при сбое. Для fzf важно заранее знать, где хранятся данные, как их скопировать и сколько времени займёт восстановление. Если ответа нет, не двигайтесь дальше: сначала закройте этот пробел, потом добавляйте новые возможности.
Типичные ошибки
Ниже — сбои, которые встречаются чаще всего. Перед исправлением сохраните текущие конфиги и запишите, какие изменения вносите: так проще откатиться.
1. Сочетания Ctrl+T и Alt+C не работают.
Интеграция не загружена. Добавьте eval «$(fzf —bash)» для Bash или соответствующий вариант для вашей оболочки и перезапустите терминал.
2. fzf открывается с пустым списком.
Проверьте команду из FZF_DEFAULT_COMMAND отдельно. Если fd не установлен или возвращает ошибку, fzf не получит входных строк.
3. Предпросмотр показывает command not found.
Команда предпросмотра выполняется в отдельной оболочке. Установите используемую утилиту или замените команду на доступную, например head или sed.
4. fzf не запускается в скрипте или CI.
fzf требует интерактивный терминал. В автоматических сценариях используйте обычные фильтры и не вызывайте интерактивное меню.
Что проверить перед вводом в работу
Перед тем как считать настройку завершённой, пройдитесь по короткому списку. Он не заменяет полноценный аудит, но отсекает большинство очевидных проблем.
Чек-лист
- Версия fzf зафиксирована, а обновления не применяются вслепую.
- Есть резервная копия конфигурации и данных, восстановление проверено.
- Доступ ограничен нужными пользователями и сетями, лишние порты закрыты.
- Логи и метрики собираются, понятно, куда смотреть при сбое.
- Изменения описаны в документации и могут быть повторены на другой машине.
- Есть план отката и понятный критерий, по которому вы решите его применить.
Если какой-то пункт вызывает затруднение, это сигнал вернуться к соответствующему разделу, а не откладывать проверку. Настройка, которую нельзя повторить, плохо работает не только у коллег, но и у вас самих через полгода.
Итог
fzf — это не «поставил и забыл». Рабочая конфигурация складывается из понимания задачи, аккуратной установки и проверки результата. Начните с базового сценария, затем добавляйте только те возможности, которые действительно используете.