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

fzf принимает строки на стандартный ввод и позволяет быстро выбрать нужную с помощью нечёткого поиска. Его используют для открытия файлов, переключения веток, поиска по истории и запуска команд. В статье настроим интеграцию с оболочкой, предпросмотр и множественный выбор. Примеры работают в Bash, Zsh и Fish на любом из популярных дистрибутивов.

Вместо запоминания точного пути достаточно ввести несколько символов. Нечёткий поиск устойчив к опечаткам и порядку символов. fzf экономит время в задачах, где обычный Tab слишком медленный или неудобный. При этом инструмент не требует базы данных и работает с любым текстовым выводом.

Большинство проблем с fzf сводится к нескольким повторяющимся ошибкам. Ниже — что проверить в первую очередь и как не усугубить ситуацию.

Почему это происходит

Ошибки почти всегда связаны с контекстом: другая версия пакета, не тот пользователь, устаревший конфиг или команда из руководства для другой системы. 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 требует интерактивный терминал. В автоматических сценариях используйте обычные фильтры и не вызывайте интерактивное меню.

Как настроить правильно

Правильная последовательность проста: проверить версию и зависимости, сделать резервную копию конфигурации, внести минимальное изменение, проверить логи и только потом двигаться дальше.

Установка

В 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"

Практические советы

Эти рекомендации проверены на повседневных задачах. Начните с тех, которые закрывают вашу текущую боль, а не со всего списка сразу.

Совет 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 связано не с ошибкой в самой программе, а с окружением: обновились зависимости, изменился путь, закончилось место или другой администратор поправил конфиг. Поэтому профилактика начинается с фиксации исходного состояния.

Сохраните рабочий конфиг в систему контроля версий, добавьте короткий комментарий о том, зачем нужен каждый нестандартный параметр, и запишите команду проверки. Через месяц вы скажете себе спасибо: восстановить логику по чужому файлу без пояснений почти невозможно.

Чек-лист

  • Версия пакета и конфигурация зафиксированы и доступны для сравнения.
  • Есть автоматическая проверка синтаксиса перед перезапуском службы.
  • Журналы ротуются, а диск не заполняется ими за неделю.
  • Изменения проходят через тестовый стенд, а не сразу на рабочий сервер.

Итог

Большинство ошибок с fzf лечится не переустановкой, а проверкой конфигурации, логов и прав доступа. Действуйте по одному изменению за раз — и причина быстро найдётся.

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

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

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

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

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