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

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 на одной машине, проверить работу и передать доступ коллеге. Начните с чистой системы или снапшота, чтобы результат был воспроизводим. Запишите все команды в отдельный файл — это одновременно шпаргалка и черновик будущей автоматизации.

Дальше действуйте короткими шагами: установка, минимальная конфигурация, проверка, затем расширение. После каждого шага фиксируйте, что именно изменилось и как это проверить. Такой журнал экономит время, когда через месяц понадобится повторить настройку на другом сервере или объяснить её коллеге.

Порядок работ для этого сценария выглядит так:

  1. Отфильтруйте простой список
  2. Включите интеграцию с оболочкой
  3. Добавьте предпросмотр файла
  4. Выберите несколько элементов
  5. Переключите ветку 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 — это не «поставил и забыл». Рабочая конфигурация складывается из понимания задачи, аккуратной установки и проверки результата. Начните с базового сценария, затем добавляйте только те возможности, которые действительно используете.

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

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

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

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

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