GeekIt

fzf命令速查

安装与基础用法、界面布局、preview 预览、bind 快捷键、多选输出、与 fd/rg 组合、git/docker/k8s 集成与报错排查等 144 条命令

共 144 条命令 · 11 类场景 · 点击右侧图标可复制

命令 / 片段说明复制
fzf --version查看版本,新版才支持 --walker 与 --disabled 等参数
fzf --help查看全部参数与键位说明
apt install fzfDebian/Ubuntu 安装,版本可能偏旧
yum install fzfRHEL/CentOS 安装
brew install fzfmacOS 安装
go install github.com/junegunn/fzf@latestGo 安装,可拿到最新特性
git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf && ~/.fzf/install官方安装脚本,会配置补全与快捷键
source <(fzf --bash)在 ~/.bashrc 中加载补全与 CTRL-T/CTRL-R/ALT-C 绑定
source <(fzf --zsh)zsh 的加载方式,写入 ~/.zshrc
fzf --fish | sourcefish 的加载方式
bindkey | grep fzf确认快捷键是否已绑定成功
默认三个快捷键:CTRL-T 选文件、CTRL-R 搜历史、ALT-C 跳目录先把这三个用顺,效率提升最明显
命令 / 片段说明复制
fzf无输入时用内置 walker 遍历当前目录文件
ls | fzf从命令输出里模糊选择
find . -type f | fzf手动指定候选来源
fd -t f | fzf用 fd 生成候选,快且结果干净
rg --files | fzf只列会被检索的文件,等价于项目文件清单
git ls-files | fzf只在 Git 跟踪的文件中选择
fzf --height 40%以浮层显示,不占满整屏
fzf --height ~100%接近全屏但保留提示行
fzf --query "config"预设初始查询词
fzf --select-1只有一个匹配时自动选中,省一次回车
fzf --exit-0没有输入时直接退出,适合脚本里使用
fzf --print-query把查询词也输出,便于记录用户意图
fzf --filter "api"非交互过滤,脚本里替代交互选择
fzf -f "api"filter 的简写形式
echo -e "a\nb\nc" | fzf --filter b无 TTY 环境下也能用,输出 b
fzf < file.txt从文件读取候选
命令 / 片段说明复制
fzf --layout=reverse提示行在底部、结果向上排列,最常用
fzf --layout=reverse-list结果由下往上,提示行在顶部
fzf --border显示边框
fzf --border=rounded圆角边框,视觉更柔和
fzf --info=inline把信息行放到提示行同一行,节省空间
fzf --prompt="选择 > "自定义提示语
fzf --pointer="▶" --marker="✓"自定义指针与多选标记符号
fzf --header="按 CTRL-/ 预览"顶部说明,提醒快捷键
fzf --header-lines=1前 N 行作为表头固定不参与搜索
fzf --cycle上下移动时循环,长列表更好用
fzf --no-clear退出后不清屏,保留结果便于对照
fzf --no-mouse禁用鼠标,避免误点
fzf --color=16使用 16 色,适配老终端
fzf --margin=1,2设置外边距,浮层更透气
fzf --separator="───"自定义结果分隔线
命令 / 片段说明复制
fzf --preview "cat {}"最基础的预览,输出文件内容
fzf --preview "head -40 {}"只预览前 40 行,避免大文件卡顿
fzf --preview "bat --color=always --line-range :60 {}"带语法高亮与行号,推荐配置
fzf --preview "file {}"先看文件类型,二进制文件不乱码
fzf --preview "ls -la {}"预览目录内容,选目录时很有用
fzf --preview "git diff --color=always {}"预览未提交改动,做提交前检查
fzf --preview-window "right:50%"预览放在右侧占一半宽度
fzf --preview-window "up:40%:wrap"预览在上方并自动换行
fzf --preview-window "down:30%:wrap"预览在下方,适合宽屏
fzf --preview-window "hidden"默认隐藏预览,按需切换,节省空间
fzf --bind "ctrl-/:toggle-preview"CTRL-/ 开关预览,最常用的一条绑定
fzf --preview "rg --color=always --line-number {} 2>/dev/null"预览时高亮匹配内容
fzf --preview "git log -1 --stat {}"预览文件最近一次提交信息
预览命令要能快速返回调用重命令会让移动光标明显卡顿
命令 / 片段说明复制
fzf --bind "ctrl-y:execute-silent(echo -n {} | pbcopy)+abort"复制选中项到剪贴板并退出
fzf --bind "enter:become(vim {})"回车直接用 vim 打开,fzf 退出后接管终端
fzf --bind "ctrl-e:execute(vim {})"执行后返回 fzf,可连续操作
fzf --bind "ctrl-r:reload(fd -t f)"重新加载候选列表
fzf --bind "ctrl-d:preview-half-page-down"预览窗口翻页,另有 up 版本
fzf --bind "ctrl-a:select-all"全选,配合 --multi 批量操作
fzf --bind "ctrl-x:toggle-all"反选全部
fzf --bind "tab:toggle+down"Tab 选中并下移,多选体验更顺
fzf --bind "alt-j:down,alt-k:up"自定义上下移动键
fzf --bind "ctrl-n:put(hello)"把文本放进查询框
fzf --bind "ctrl-o:jump"跳转模式,支持类似 ls 的路径跳转
fzf --expect ctrl-x,ctrl-v把按下的自定义键作为首行输出
fzf --disabled --bind "change:reload(rg {} || true)"关闭内置过滤,改为每次输入都重新检索
action 列表:accept/abort/execute/become/reload/toggle/preview/select记住常用几个即可覆盖大部分场景
命令 / 片段说明复制
fzf --multi开启多选,Tab/Shift-Tab 标记
fzf -mmulti 的简写
fzf --multi --bind "ctrl-a:select-all+accept"一键全选并确认
fzf --print0用 NUL 分隔输出,交给 xargs -0
fzf --read0输入按 NUL 分隔,处理含空格或换行的路径
fd -0 | fzf --read0 --print0 | xargs -0 rm含空格路径批量删除的安全写法
vim $(fzf --multi)一次打开多个选中文件
fzf --multi | xargs -I{} echo {}逐行处理多选结果
fzf --multi --print-query首行是查询词,其余为选中项,注意解析顺序
fzf --expect ctrl-x | head -1取按键名,便于分支处理
fzf | wc -l统计选了几项,脚本里做校验
退出码 0 选中、1 无匹配、130 中断脚本判断用户是否取消操作
命令 / 片段说明复制
fd | fzf --preview "bat --style=numbers --color=always {}"最经典的文件选择器组合
rg -l "TODO" | fzf --preview "rg -n --color=always TODO {}"先筛出含关键词的文件,再定位到具体行
fd -e yaml | fzf --preview "yq . {}"预览 YAML 解析结果
fd -e json | fzf --preview "jq . {}"预览 JSON 格式化结果
fd -t d | fzf只选目录,配合 cd 使用
cd "$(fd -t d | fzf)"目录快速跳转,比手打路径快得多
vim "$(rg --files | fzf --preview "head -30 {}")"选完直接打开,一步到位
fd -e log | fzf --preview "tail -30 {}"日志文件预览尾部内容
fd -e md | fzf --preview "glow -w 80 {} 2>/dev/null || head -40 {}"Markdown 渲染预览,没有工具时降级为 head
fzf --preview "grep -n {} /dev/null 2>/dev/null; wc -l {}"预览文件行数等元信息
命令 / 片段说明复制
git branch | fzf分支选择器的基础形式
git checkout $(git branch --format="%(refname:short)" | fzf)模糊切换分支
git log --oneline | fzf --preview "git show --stat {1}"选提交并预览改动统计
git show $(git log --oneline | fzf | awk '{print $1}')查看选中提交的完整改动
git status -s | fzf --multi从改动文件里多选,便于批量 add
git stash list | fzf选择 stash 记录
kubectl get pods -A | fzfPod 太多时用模糊筛选
kubectl get pods -A | fzf | awk '{print $1" "$2}'输出命名空间与 Pod 名,便于后续拼接命令
kubectl config get-contexts | fzf集群上下文选择
docker ps --format "{{.ID}} {{.Names}}" | fzf容器选择,再拼 docker exec 或 logs
ps aux | fzf | awk '{print $2}' | xargs -r kill进程查找并结束,执行前先确认 PID
ss -tlnp | fzf端口与进程对照,排查占用很方便
ls ~/.ssh/config 2>/dev/null && grep "^Host " ~/.ssh/config | cut -d" " -f2 | fzfSSH 主机选择器,再拼 ssh 命令
命令 / 片段说明复制
fzf --filter "pattern" < list.txt非交互过滤,行为类似 grep
fzf --filter "pattern" --select-1只取第一个匹配,适合脚本自动决策
fzf --filter "" --no-sort < list.txt | head -5不做排序直接取前几项
fzf --print-query --filter "x"脚本中需要同时拿到查询词与结果时
if out=$(fzf < list.txt); then echo "$out"; fi用退出码判断用户是否取消
fzf --exit-0 --select-1无匹配或被 cancel 时都安全退出,CI 里常用
echo "$LIST" | fzf --height 40%变量作为候选源,注意换行已存在
fzf --no-height强制全屏,脚本环境下避免浮层问题
FZF_DEFAULT_OPTS="--height 40% --layout=reverse" fzf临时覆盖默认参数
偏好设置写在 shell rc 中脚本里显式传参,避免依赖用户环境
命令 / 片段说明复制
export FZF_DEFAULT_COMMAND="fd -t f -H"自定义候选生成命令,替换默认的 find
export FZF_DEFAULT_OPTS="--height 50% --layout=reverse --border --preview 'head -40 {}'"全局默认参数,写在 ~/.bashrc 或 ~/.zshrc
export FZF_DEFAULT_OPTS_FILE=~/.config/fzf/fzfrc把长参数放文件里,便于版本管理
export FZF_CTRL_T_COMMAND="fd -t f -H"定制 CTRL-T 的候选来源
export FZF_ALT_C_COMMAND="fd -t d"定制 ALT-C 的目录来源
fzf --walker=file,dir,follow,hidden内置 walker 的遍历范围(新版参数)
fzf --walker-root=src限定内置 walker 的起始目录
fzf --walker-skip=.git,node_modules跳过指定目录,减少候选数量
fzf --sync同步匹配,百万行时反而更稳
fzf --no-sort不排序,列表极大时明显提速
fzf --tac反转输入顺序,最新日志在最上面
fzf --listen 6266开启 HTTP 接口,可外部控制选择(进阶)
预览命令尽量轻量这是影响手感的最大变量,比调参数更重要
命令 / 片段说明复制
fzf: command not found未安装或不在 PATH,确认安装方式
unknown option: --xxx版本过低,升级后才有该参数
unknown action: xxxbind 的动作名写错,用 fzf --help 核对
preview 一直空白预览命令报错被吞掉,先去掉 2>/dev/null 看输出
preview 不随光标刷新命令里用了固定文件名而不是 {}
execute 中引号被吃掉动作里的表达式需整体用单引号包裹
become 后终端不还原become 会替换进程,必须配合全屏程序使用
按 CTRL-T 没有反应补全脚本没加载,确认 source <(fzf --bash) 已写入 rc
候选列表为空FZF_DEFAULT_COMMAND 指定的命令不存在,改为 fd 或 find
中文宽字符错位终端字体或 locale 问题,设置 UTF-8 并换等宽字体
tmux 下预览错位用 fzf-tmux 或调大窗口,避免浮层尺寸计算异常
脚本里 fzf 直接退出无 TTY 时用 --filter 或 --select-1 --exit-0
多选结果解析错乱路径含换行时用 --read0 --print0
--expect 输出多了一行首行是按键名,解析时记得跳过
大目录打开很慢减少候选源、加 --walker-skip 或改用 fd 预筛

运维常用组合

文件快速打开fd | fzf --height 50% --preview "bat --color=always --line-range :60 {}" --bind "enter:become(vim {})"
定向检索后打开rg -l "TODO" | fzf --preview "rg -n --color=always TODO {}" --bind "enter:become(vim {})"
分支切换git checkout $(git branch --format="%(refname:short)" | fzf)
Pod 定位kubectl get pods -A | fzf | awk '{print $1" "$2}' | xargs -n2 sh -c "kubectl -n $0 logs $1 --tail=100"
批量删除fd -0 -e bak | fzf --read0 --multi --print0 | xargs -0 rm -v
脚本安全选择sel=$(printf "%s\n" "$LIST" | fzf --filter "${1:-}" --select-1) || exit 1

实战要点

1. 先装补全脚本

source <(fzf --bash) 后再用 CTRL-T/CTRL-R/ALT-C,收益比记参数大得多

2. 预览要轻量

预览命令越重手感越差,用 head/bat --line-range 限制输出量

3. 候选源用 fd

FZF_DEFAULT_COMMAND 换成 fd -t f -H,快且自动遵守忽略规则

4. 脚本用 --filter

非交互场景不要依赖 TTY,用 --filter 或 --select-1 --exit-0

5. 路径含空格用 NUL

--read0 配 --print0 再交给 xargs -0,避免分词错误

6. 按退出码分支

0 选中、1 无匹配、130 取消,脚本里必须区分这三种情况

共 144 条 fzf 命令 · 示例中的路径与命令请替换为实际环境

关于fzf命令速查

在线 fzf 命令速查手册,按安装与版本、基础用法、界面与布局、预览窗口、bind 快捷键与动作、多选与输出、与 fd/rg 组合、git 与 docker/k8s 集成、脚本与非交互用法、配置与性能、常见报错与排查等 11 类场景整理 140 余条常用命令与参数组合,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 fzf --version 与 apt/yum/brew/go install 与 git clone 安装脚本与 --bash/--zsh/--fish 补全绑定与 CTRL-T/CTRL-R/ALT-C 默认快捷键、fzf 与 ls/find/fd/rg --files/git ls-files 管道、--height 与 --layout=reverse 与 --border=rounded 与 --info=inline 与 --prompt 与 --pointer 与 --marker 与 --header 与 --header-lines 与 --multi 与 --no-multi 与 --query/-q 与 --exact 与 --case-sensitive 与 --ignore-case 与 --tac 与 --no-sort 与 --tiebreak 与 --nth/--with-nth/--delimiter 与 --select-1/-1 与 --exit-0 与 --print-query 与 --print0/--read0 与 --filter 非交互过滤、--preview 与 cat/head/bat/file/git diff 预览与 --preview-window right:50%/up:30%:wrap/hidden、--bind 的 toggle-preview/reload/execute/execute-silent/become/put/accept/abort/select-all 与 enter:become(vim {}) 与 ctrl-r:reload 与 --expect 返回按键、FZF_DEFAULT_COMMAND 与 FZF_DEFAULT_OPTS 与 FZF_DEFAULT_OPTS_FILE 与 FZF_CTRL_T_COMMAND 与 FZF_ALT_C_COMMAND、--walker/--walker-root/--walker-skip 与 --disabled + change:reload 与 --listen 与 --sync 与 --no-mouse,以及 cd $(fd -t d | fzf)、vim $(fzf)、git checkout $(git branch | fzf)、git log --oneline | fzf --preview、kubectl get pods | fzf、docker ps | fzf、ps aux | fzf、kill $(ps -ef | fzf | awk)、ssh 主机选择等实用组合,还有 command not found、unknown option、unknown action、preview 不刷新、execute 引号与转义、--expect 输出解析、无匹配退出码 1、中文宽字符对齐、tmux 下错位、FZF_DEFAULT_COMMAND 命令不存在导致空白 等报错排查。适用于终端文件快速跳转与打开、命令历史检索、git 分支与提交选择、Kubernetes 与 Docker 资源定位、日志与进程筛选、批量操作的多选交互,以及运维、SRE 与后端工程师效率提升与面试复习。

核心能力

  • 涵盖 fzf --version 与 apt/yum/brew/go install 与 git clone 安装脚本与 --bash/--zsh/--fish 补全绑定与 CTRL-T/CTRL-R/ALT-C 默认快捷键、fzf 与 ls/find/fd/rg --files/git ls-files 管道、--height 与 --layout=reverse 与 --border=rounded 与 --info=inline 与 --prompt 与 --pointer 与 --marker 与 --header 与 --header-lines 与 --multi 与 --no-multi 与 --query/-q 与 --exact 与 --case-sensitive 与 --ignore-case 与 --tac 与 --no-sort 与 --tiebreak 与 --nth/--with-nth/--delimiter 与 --select-1/-1 与 --exit-0 与 --print-query 与 --print0/--read0 与 --filter 非交互过滤、--preview 与 cat/head/bat/file/git diff 预览与 --preview-window right:50%/up:30%:wrap/hidden、--bind 的 toggle-preview/reload/execute/execute-silent/become/put/accept/abort/select-all 与 enter:become(vim {}) 与 ctrl-r:reload 与 --expect 返回按键、FZF_DEFAULT_COMMAND 与 FZF_DEFAULT_OPTS 与 FZF_DEFAULT_OPTS_FILE 与 FZF_CTRL_T_COMMAND 与 FZF_ALT_C_COMMAND、--walker/--walker-root/--walker-skip 与 --disabled + change:reload 与 --listen 与 --sync 与 --no-mouse,以及 cd $(fd -t d | fzf)、vim $(fzf)、git checkout $(git branch | fzf)、git log --oneline | fzf --preview、kubectl get pods | fzf、docker ps | fzf、ps aux | fzf、kill $(ps -ef | fzf | awk)、ssh 主机选择等实用组合,还有 command not found、unknown option、unknown action、preview 不刷新、execute 引号与转义、--expect 输出解析、无匹配退出码 1、中文宽字符对齐、tmux 下错位、FZF_DEFAULT_COMMAND 命令不存在导致空白 等报错排查

适用场景

适用于终端文件快速跳转与打开、命令历史检索、git 分支与提交选择、Kubernetes 与 Docker 资源定位、日志与进程筛选、批量操作的多选交互,以及运维、SRE 与后端工程师效率提升与面试复习。fzf命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

fzf命令速查是免费的吗?需要注册或安装吗?
fzf命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
fzf命令速查支持哪些功能?
涵盖 fzf --version 与 apt/yum/brew/go install 与 git clone 安装脚本与 --bash/--zsh/--fish 补全绑定与 CTRL-T/CTRL-R/ALT-C 默认快捷键、fzf 与 ls/find/fd/rg --files/git ls-files 管道、--height 与 --layout=reverse 与 --border=rounded 与 --info=inline 与 --prompt 与 --pointer 与 --marker 与 --header 与 --header-lines 与 --multi 与 --no-multi 与 --query/-q 与 --exact 与 --case-sensitive 与 --ignore-case 与 --tac 与 --no-sort 与 --tiebreak 与 --nth/--with-nth/--delimiter 与 --select-1/-1 与 --exit-0 与 --print-query 与 --print0/--read0 与 --filter 非交互过滤、--preview 与 cat/head/bat/file/git diff 预览与 --preview-window right:50%/up:30%:wrap/hidden、--bind 的 toggle-preview/reload/execute/execute-silent/become/put/accept/abort/select-all 与 enter:become(vim {}) 与 ctrl-r:reload 与 --expect 返回按键、FZF_DEFAULT_COMMAND 与 FZF_DEFAULT_OPTS 与 FZF_DEFAULT_OPTS_FILE 与 FZF_CTRL_T_COMMAND 与 FZF_ALT_C_COMMAND、--walker/--walker-root/--walker-skip 与 --disabled + change:reload 与 --listen 与 --sync 与 --no-mouse,以及 cd $(fd -t d | fzf)、vim $(fzf)、git checkout $(git branch | fzf)、git log --oneline | fzf --preview、kubectl get pods | fzf、docker ps | fzf、ps aux | fzf、kill $(ps -ef | fzf | awk)、ssh 主机选择等实用组合,还有 command not found、unknown option、unknown action、preview 不刷新、execute 引号与转义、--expect 输出解析、无匹配退出码 1、中文宽字符对齐、tmux 下错位、FZF_DEFAULT_COMMAND 命令不存在导致空白 等报错排查。
fzf命令速查适合哪些场景使用?
适用于终端文件快速跳转与打开、命令历史检索、git 分支与提交选择、Kubernetes 与 Docker 资源定位、日志与进程筛选、批量操作的多选交互,以及运维、SRE 与后端工程师效率提升与面试复习。