模糊查找器

技能简介

fzf 是一款通用的命令行模糊查找器，支持从标准输入读取列表并通过交互式界面快速筛选目标项。可与 Shell、Vim 及各类 Unix 工具链深度整合。

业务背景

适用于命令行高频操作场景，帮助开发运维人员从海量文件、日志或进程列表中快速定位目标。通过实时模糊匹配替代逐行浏览，显著缩短查找时间，降低因路径记忆错误或输入完整文件名带来的操作负担。

落地案例：运维人员排查故障时需在海量日志文件中定位特定错误关键词，使用fzf配合ripgrep可实时筛选匹配结果，并通过预览窗口直接查看文件内容确认上下文，无需反复打开关闭编辑器，快速完成问题定位。

能做什么

• 对文件列表、命令历史、Git 分支等进行实时模糊匹配
• 多选模式批量操作文件或进程
• 内置预览窗口查看文件内容或目录结构
• 自定义快捷键绑定执行特定动作
• 与 ripgrep、fd、docker、kubectl 等工具组合使用

使用说明

安装指令

# macOS (Homebrew)
brew install fzf

# Ubuntu/Debian (apt)
sudo apt install fzf

# 启用 Shell 集成（安装后执行）
$(brew --prefix)/opt/fzf/install  # Homebrew 路径
# 或手动添加至 ~/.bashrc / ~/.zshrc:
# source /usr/share/doc/fzf/examples/completion.bash
# source /usr/share/doc/fzf/examples/key-bindings.bash

基础用法

# 管道输入筛选
ls | fzf
find . -type f | fzf

# 多选模式（Tab 选择，Shift+Tab 取消）
ls | fzf -m

# 预览文件内容
ls | fzf --preview 'cat {}'
ls | fzf --preview 'bat --color=always {}'

# Shell 快捷键（需先配置集成）
Ctrl+R  # 搜索命令历史
Ctrl+T  # 文件路径补全
Alt+C   # 目录跳转

常用场景

# 用 Vim 打开选中文件
vim $(fzf --preview 'bat --color=always --line-range :500 {}')

# Git 分支切换
git branch | fzf | xargs git checkout

# 终止选中进程
ps aux | fzf | awk '{print $2}' | xargs kill

# Docker 容器进入
docker ps | fzf | awk '{print $1}' | xargs -I {} docker exec -it {} bash

输入与输出

见下方输入与输出表格。

风险提示

• 多选模式下误操作可能导致批量删除或修改
• 进程终止操作不可逆，请确认目标 PID 后再执行
• 预览功能依赖外部工具（如 bat），未安装时显示原始内容
• Shell 集成脚本路径因安装方式而异，需核对实际位置

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/arnarsson/fzf-fuzzy-finder/SKILL.md
来源类型：开源社区文档