Linux 下的模糊查找神器 fzf 使用教程

简介

fzf 是一款功能强大且用途广泛的 Linux 命令行模糊查找器。它允许用户使用模糊匹配高效地搜索和过滤文本、文件和命令历史记录。

它是一个交互式过滤程序，适用于任何类型的列表；文件、命令历史、进程、主机名、书签、git提交等。它实现了一种“模糊”匹配算法，因此可以快速键入带有省略字符的模式，并且仍然可以得到想要的结果。

安装

Debian/Ubuntu

sudo apt install fzf

Red Hat/CentOS

sudo dnf install fzf

MacOS

brew install fzf

从源码安装

git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf

~/.fzf/install

常用选项

大多数长选项都有带有 --no- 前缀的相反版本。

-x, --extended：扩展搜索模式，默认启用。可以使用 +x 或 --no-extended 禁用
-e, --exact：精确匹配搜索
-i, --ignore-case：大小写不敏感，默认是(smart-case)，即智能识别大小写匹配
+i, --no-ignore-case：大小写敏感匹配
+s, --no-sort：不排序匹配到的结果
--tail=：内存中保存的最大项目数，当使用 fzf 浏览无限数据流（例如日志流）同时限制内存使用量时，这很有用。

示例：

# Interactive filtering of a log stream
tail -f *.log | fzf --tail 100000 --tac --no-sort --exact

--tac：反转输入的顺序
-m, --multi：使用 tab/shift-tab 启用多选
+m, --no-multi：禁用多选
--bind=：自定义绑定键事件，用逗号分割
--wrap：启用换行
--height=：按照给定的高度在光标下方显示 fzf 窗口，而不是使用全屏，如果指定了负值，则高度计算为终端高度减去给定值

示例：

fzf --height=-1

当以 ~ 为前缀时，fzf 会根据输入的大小自动确定范围内的高度

fzf --height=~70%

--min-height=：当 --height 以百分比形式指定时，指定的最小高度（默认值：10）。当未指定 --height 时，将被忽略。
--layout=：布局选择，可用的值有：

default：从屏幕底部显示
reverse：从屏幕顶部显示
reverse-list：从屏幕顶部显示，在底部提示

--reverse：与 --layout=reverse 等同
--prompt=：输入提示符，默认是 >
--pointer=：指向当前行的指针，默认是 ▌ 或 >
--marker=：多选标记，默认是 ▌ 或 >
-q, --query=：使用给定的查询启动查找器
-0, --exit-0：如果初始查询（--query）没有匹配项，则不启动交互式查找器并立即退出
-f, --filter=：过滤模式。不启动交互式查找器，与 --no-sort 一起使用时，fzf 将成为 grep 的模糊匹配版本
--version：显示版本信息
--help：显示帮助信息
--man：查看命令手册

`shell` 集成

--bash

eval "$(fzf --bash)"

--zsh

source <(fzf --zsh)

--fish

fzf --fish | source

设置环境变量

FZF_DEFAULT_COMMAND

设置默认命令

export FZF_DEFAULT_COMMAND='find . -type f'

FZF_DEFAULT_OPTS

设置默认选项

export FZF_DEFAULT_OPTS="--layout=reverse --border --cycle"

FZF_DEFAULT_OPTS_FILE

包含默认选项的文件的位置

export FZF_DEFAULT_OPTS_FILE=~/.fzfrc

扩展搜索模式

精确匹配（引用）

以单引号字符 (') 为前缀的术语被解释为“完全匹配”（或“非模糊”）术语。

锚定匹配

以 ^ 为前缀表示匹配以给定字符串开头的行
以 $ 为后缀表示匹配以给定字符串结尾的行

否定匹配

以 ! 开头的字符串，表示排除给定字符串的行

OR 操作符，匹配多个字符串中的任一个

示例：

^core go$ | rb$ | py$

示例用法

基础用法

打开交互式界面，搜索当前目录中的所有文件。

使用箭头键或键入字符来过滤结果

fzf

查找指定的文件

find . -type f | fzf

搜索命令历史

history | fzf

预览文件内容

启用文件内容的预览窗口

fzf --preview="cat {}"

通过 `SSH` 使用 `fzf`

从 ~/.ssh/config 或 known_hosts 中过滤 SSH 主机

cat ~/.ssh/known_hosts | cut -f 1 -d ' ' | fzf

搜索进程

ps aux | fzf

绑定自定义导航键

fzf --bind='ctrl-k:kill-line,ctrl-u:unix-line-discard'

指定输入源

ls /path/to/files | fzf

直接向 `fzf` 传递查询

fzf -f "query"

与 `vim` 结合使用

vim $(find . -type f | fzf)

交互式变更目录

cd $(find . -type d | fzf)

与 `git` 集成

git branch | fzf

启用多选

使用 Tab 选择多个项目

fzf --multi

使用 `--preview` 选项获取详细输出

fzf --preview="bat --style=numbers --color=always --line-range :500 {}"

过滤指定的文件

find . -name "*.txt" | fzf