fzf命令速查
安装与基础用法、界面布局、preview 预览、bind 快捷键、多选输出、与 fd/rg 组合、git/docker/k8s 集成与报错排查等 144 条命令
共 144 条命令 · 11 类场景 · 点击右侧图标可复制
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
fzf --version | 查看版本,新版才支持 --walker 与 --disabled 等参数 | |
fzf --help | 查看全部参数与键位说明 | |
apt install fzf | Debian/Ubuntu 安装,版本可能偏旧 | |
yum install fzf | RHEL/CentOS 安装 | |
brew install fzf | macOS 安装 | |
go install github.com/junegunn/fzf@latest | Go 安装,可拿到最新特性 | |
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 | source | fish 的加载方式 | |
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 -m | multi 的简写 | |
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 | fzf | Pod 太多时用模糊筛选 | |
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 | fzf | SSH 主机选择器,再拼 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: xxx | bind 的动作名写错,用 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)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 -vsel=$(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 取消,脚本里必须区分这三种情况
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
Nginx命令速查
服务管理、配置指令、反向代理、HTTPS、限流缓存、日志排查等 Nginx 常用命令速查手册
K8S命令速查
集群上下文、Pod调试、工作负载、Service与Ingress、存储、权限、排障等 kubectl 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
关于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 与后端工程师效率提升与面试复习。