【fff.nvim】一个为 AI 编程助手和 Neovim 用户量身打造的极速文件搜索工具
FFF.nvim 是一款专为 AI 编程助手（如 Claude Code、Codex 等）和 Neovim 用户设计的高性能模糊文件搜索工具，它解决了传统文件查找工具在大型代码库中响应慢、结果不相关、缺乏上下文记忆等问题，让“找文件”这件事既快又聪明。
主要功能与特性包括：
– ✅ 极速模糊文件查找：基于自研优化算法，支持 frecency（访问频率+时间衰减）、Git 状态、文件大小、定义匹配等多维打分，返回最可能需要的文件
– ✅ 三模 Live Grep：支持 plain（字面匹配）、regex（正则表达式）和 fuzzy（Smith-Waterman 模糊匹配）三种搜索模式，可一键切换
– ✅ 跨模式智能建议：当文件搜索无结果时，自动提供内容匹配建议；当 grep 无结果时，自动推荐匹配的文件名
– ✅ 深度 Git 集成：实时显示文件 Git 状态（staged/modified/deleted 等），支持 git:modified 等约束语法精准过滤
– ✅ 内存增强型搜索：内置文件打开频次（frecency）与查询组合记忆（combo boost），越用越懂你
– ✅ 灵活约束语法：支持 !ignored, test/**, ./**/*.rs, git:staged src/ 等组合式过滤，无需写复杂命令
– ✅ 多选 + Quickfix 集成：一键多选文件并推送至 Neovim 快速修复列表，提升批量操作效率
安装与快速上手：
– AI 代理集成：运行以下命令即可为你的 AI 工具添加 FFF 支持：
bash
curl -L https://dmtrkovalenko.dev/install-fff-mcp.sh | bash
安装后，在提示词中告诉 AI “use fff”，它就能调用本地极速搜索能力。
– Neovim（lazy.nvim）安装示例：
lua
{ 'dmtrKovalenko/fff.nvim',
build = function() require('fff.download').download_or_build_binary() end,
opts = {},
keys = {
{ 'ff', function() require('fff').find_files() end, desc = 'FFFind files' },
{ 'fg', function() require('fff').live_grep() end, desc = 'LiFFFe grep' },
}
}
安装后按 <leader>ff 即可唤起文件搜索器，开箱即用。
该项目特别适合以下场景：
– AI 编程助手用户：希望减少 token 消耗、避免反复读取无关文件、让 AI 更快定位目标代码的开发者；
– Neovim 高频代码浏览者：在大型项目（如 Linux 内核仓库，10 万+ 文件）中需要秒级响应、高精度筛选、带 Git 上下文的文件导航体验；
– 注重效率与定制性的工程师：愿意通过简单 Lua 配置启用路径截断策略、预览行为、高亮样式、日志调试等细粒度控制。
总结：FFF.nvim 不是一个“又一个 fzf 替代品”，而是一次面向未来编程工作流的重新思考——它把文件搜索从“命令行辅助”升级为“AI 记忆延伸”和“编辑器原生感知”。性能扎实、设计克制、文档详尽，是当前 Neovim 生态中少有的、真正兼顾人类直觉与 AI 友好性的搜索基础设施。值得所有追求开发速度与智能协同的用户尝试。
