在fzf中实现仅定位不筛选的查询功能

fzf作为一个强大的命令行模糊查找工具，其核心功能是通过查询字符串快速筛选和定位目标项。但在某些特定场景下，用户可能只需要定位到某个特定项而不希望影响其他项的显示。

需求背景

在使用Vim插件调用fzf时（如GFiles命令），开发者希望将当前文件作为查询参数传递给fzf，使选择光标自动定位到当前文件位置，同时保留完整的文件列表以便查看相邻文件。然而直接使用--query参数会同时触发筛选功能，导致非匹配项被隐藏。

技术挑战

实现仅定位不筛选的功能面临几个技术难点：

1. 异步加载问题：fzf采用异步加载机制，在列表完全加载前无法确定目标项位置
2. 性能考量：实时检查每个新项是否匹配会影响处理速度
3. 用户体验：需要确保定位后界面显示稳定，避免光标跳动

解决方案

最新版fzf（0.61.0及以上）通过transform绑定和--sync参数组合实现了这一功能。核心思路是：

1. 使用--sync参数使fzf在定位完成前保持阻塞状态
2. 通过transform绑定实现条件逻辑：
   • 当查询字符串存在时，跟踪当前匹配项并清除查询
   • 完成后取消跟踪，重置光标位置并解除绑定

Vim集成示例

在Vim中可这样实现带预览的Git文件定位功能：

function GFilesWithPreview()
  call fzf#vim#gitfiles('', {'options': [
        \ '--sync',
        \ '--query', expand('%h'),
        \ '--bind', 'result:transform:
           \  if [[ -n $FZF_QUERY ]]; then
           \      echo "track-current+clear-query"
           \  else
           \      echo "untrack-current+offset-middle+unbind(result)"
           \  fi',
        \ '--preview', 'bat -p --color always {}'],
        \ 'window': { 'width': 0.9, 'height': 0.9 }})
endfunction

注意事项

1. 确保使用最新版fzf（0.61.0+），旧版本可能存在显示问题
2. 不同shell对语法要求不同（如bash与zsh的分号处理差异）
3. 在插件环境中要确认实际调用的fzf二进制是否为最新版本

这一功能扩展了fzf在IDE集成中的实用性，使开发者能快速定位到工作上下文相关文件，同时保持完整的项目文件结构视图。