fzf - поиск файлов и команд

Установка
Синтаксис
Опции
Пример работы
Дополнительные примеры

Окружение

• Версия ОС: 8
• Конфигурация ОС: Рабочая станция
• Редакция ОС: Стандартная
• Архитектура: x86_64
• Версия ПО: fzf-0.54.3-1

fzf (fuzzy finder) — это программа для поиска в командной строке, которая позволяет искать файлы, каталоги и другие типы данных. Она сопоставляет вводимые данные с имеющимися и ранжирует результаты по релевантности.

Основные возможности:

• fuzzy-поиск — ищет совпадения по неточным введённым данным (например, psql найдёт postgresql);

• интерактивный предварительный просмотр — результаты обновляются в реальном времени при вводе;

• гибкость — работает с любыми текстовыми данными (файлы, процессы, история команд и т. д.);

• функция множественного выбора — позволяет одновременно выбирать несколько элементов;

• сочетания клавиш — поддерживает сочетания клавиш, которые упрощают использование и навигацию;

• подсветка — выделяет совпадения.

Установка

Для установки утилиты выполните команду (потребуются права администратора):

sudo dnf install fzf

Дальнейшая работа в программе выполняется от локального пользователя.

Для вывода версии программы выполните команду:

fzf --version

Синтаксис

Утилита доступна для запуска через терминал при помощи команды следующего вида:

fzf [опции]

Опции

Основные опции утилиты:

1. Параметры поиска:

• -x, --extended — расширенный поиск (включён по умолчанию, +x — отключает расширенный поиск);

• -e, --exact — точное совпадение;

• -i, --ignore-case — регистронезависимый поиск;

• +i, --no-ignore-case — чувствительный к регистру поиск;

• --scheme=SCHEME — алгоритм ранжирования;

• --literal — не нормализовать Unicode-символы при поиске;

• -n, --nth=N — искать только в определённых столбцах;

• --with-nth=N — показывать только указанные столбцы;

• -d, --delimiter=STR — разделитель полей;

• +s, --no-sort — не сортировать результаты;

• --tac — развернуть порядок вывода;

• --disabled — не выполнять поиск;

• --tiebreak=CRI — критерии сортировки при равных score.

2. Настройки интерфейса:

• -m, --multi[=MAX] — мультивыбор (через Tab / Shift+Tab);

• --no-mouse — отключить поддержку мыши;

• --bind=KEYBINDS — кастомные горячие клавиши;

• --cycle — циклическая прокрутка;

• --wrap — перенос длинных строк;

• --keep-right — показывать конец строки при переполнении;

• --scroll-off=N — отступ при прокручивании (сколько строк оставлять сверху/снизу);

• --filepath-word — перемещение по словам с учётом/в путях;

• --jump-labels=CHARS — символы для быстрого перехода.

3. Параметры отображения:

• --height=HEIGHT[%] — высота окна;

• --layout=LAYOUT — расположение;

• --border[=STYLE] — стиль рамки;

• --border-label=LABEL — текст на рамке;

• --margin=MARGIN — отступы;

• --padding=PADDING — внутренние отступы;

• --info=STYLE — отображение количества результатов;

• --prompt=STR — изменить приглашение ввода (по умолчанию >);

• --pointer=STR — символ выделения строки;

• --header=STR — заголовок над списком;

• --header-lines=N — использует первые N строк ввода как фиксированный заголовок.

4. Настройки оформления:

• --ansi — поддержка ANSI-цветов;

• --color=COLSPEC — цветовая схема;

• --highlight-line — подсвечивать всю текущую строку;

• --no-bold — не использовать жирный текст.

5. Работа с историей:

• --history=FILE — файл истории;

• --history-size=N — максимальное число записей (по умолчанию 1000).

6. Предпросмотр содержимого:

• --preview=CMD — команда предпросмотра;

• --preview-window=OPT — настройки окна предпросмотра:

• right:50% — расположение и размер;

• wrap — перенос строк;

• hidden — скрыть, пока не выбрано;

• border-sharp — стиль рамки.

7. Интеграция и автоматизация:

• -q, --query=STR — начать с заданным запросом;

• -1, --select-1 — автоматически выбрать единственный результат;

• -0, --exit-0 — выйти, если нет результатов;

• -f, --filter=STR — неинтерактивный режим (фильтрация без UI);

• --print-query — вывести запрос как первую строку вывода;

• --expect=KEYS — клавиши для дополнительных действий;

• --listen=PORT — запустить HTTP-сервер для удалённого управления.

8. Дополнительные настройки:

• FZF_DEFAULT_COMMAND — команда по умолчанию;

• FZF_DEFAULT_OPTS — опции по умолчанию.

Пример работы

Для поиска по файлам введите команду:

fzf

После ввода команды откроется интерактивное окно поиска:

В интерактивном режиме можно выполнять следующие действия:

1. Для поиска файлов начните печатать название файла, fzf будет фильтровать результаты в реальном времени.

Можно вводить неточные совпадения (например, uer найдет user):

2. Для навигации можно использовать:

• ↑ / ↓ (или Ctrl+P / Ctrl+N) — перемещение по списку;

• Enter — выбрать текущий файл и завершить работу fzf (результат передастся в вывод);

• Esc / Ctrl+C — выйти без выбора.

3. После выбора файла путь к файлу появится в терминале:

Дополнительные примеры

1. Для поиска по каталогам введите команду:

find . -type f | fzf

Вывод команды:

2. Для поиска в истории команд нужной команды выполните:

history | fzf

Выводит список команд из истории и позволяет найти нужную команду.

3. Для поиска файла в каталоге выполните команду:

ls | fzf

Команда выведет список всех файлов в каталоге, а затем с помощью fzf найдите нужный файл.

4. Для просмотра истории команд с переходом в директорию выполните команду:

cd $(find ~ -type d | fzf --height 40% --border)

Дата последнего изменения: 07.07.2025

Если вы нашли ошибку, пожалуйста, выделите текст и нажмите Ctrl+Enter.