如何启动带匹配上下文预览功能的fzf文本搜索

要实现管道输入fzf时，实时展示搜索词匹配项前后5行上下文（和grep -C5效果一致），核心是先完整缓存管道传入的全部文本，再通过fzf的实时预览回调，调用grep动态渲染上下文结果，具体实现如下：

可直接复用的封装方案 #

把下面的shell函数加入你的.bashrc/.zshrc配置文件，重载配置后即可直接使用：

fzf-grep-context() {
  # 创建临时文件存储管道输入的全部内容
  local tmp_file=$(mktemp)
  trap "rm -f '$tmp_file'" EXIT
  cat > "$tmp_file"

  # 启动fzf并配置上下文预览
  fzf < "$tmp_file" \
    --ansi \
    --preview 'grep -n -F -- "$FZF_QUERY" "'"$tmp_file"'" -C5' \
    --preview-window 'down,60%,border-top,+{2}+3/3,~3' \
    --bind 'change:refresh-preview'
}

使用方式：直接通过管道传入文本即可，比如：

# 搜索server.log里的内容，带5行上下文预览
cat /var/log/server.log | fzf-grep-context

参数说明 #

• 临时文件缓存逻辑：解决管道流只能单次读取、fzf无法回溯获取匹配行前后内容的问题，脚本退出（包括异常中断）时自动删除临时文件不留垃圾
• --preview配置：调用grep以当前fzf搜索框的内容（内置变量$FZF_QUERY）为关键词，在完整缓存文本中搜索，-C5参数固定输出匹配行前后各5行上下文，-F参数默认按固定字符串匹配，避免特殊正则字符引发报错，需要正则匹配时删掉-F即可
• --preview-window配置：预览窗口放在界面下方占60%高度，自动滚动定位到匹配行位置，避免匹配内容超出预览窗口可视范围
• --bind 'change:refresh-preview'：搜索框内容每次变化时立刻刷新预览，实现和实时执行grep -C5一致的无延迟效果

如果你用的fzf版本低于0.22.0，不支持$FZF_QUERY变量，把--preview的参数替换为echo "$FZF_QUERY" | grep -nFf - "'"$tmp_file"'" -C5即可正常使用。

自定义调整 #

如果需要灵活调整上下文行数，把grep的-C5替换为-C${CONTEXT_LINE_NUM:-5}即可，使用时可以通过环境变量临时指定上下文行数：

# 展示前后3行上下文
CONTEXT_LINE_NUM=3 cat test.txt | fzf-grep-context

该方案在MB级别的文本输入下无明显卡顿，grep原生的文本检索性能足够支撑实时预览的响应要求。

内容的提问来源于stack exchange，提问作者jackhab