Neovim Telescope配置报错求助：fzf扩展无法加载问题排查

问题描述 #

在PowerShell 7中启动Neovim时触发Telescope配置错误，尽管运行:checkhealth telescope显示全部状态为Ok，但加载fzf扩展时提示找不到libfzf.dll模块。

错误信息 #

Failed to run config for telescope.nvim
...a/lazy/telescope.nvim/lua/telescope/_extensions/init.lua:10: 'fzf' extension doesn't exist or isn't installed: ...nvim-data/lazy/telescope-fzf-native.nvim/lua/fzf_lib.lua:11: cannot load module 'C:/Users/{ME}/AppData/Local/nvim-data/lazy/telescope-fzf-native.nvim/lua/../build/libfzf.dll': The specified module could not be found.

堆栈跟踪:

• telescope.nvim\lua\telescope_extensions\init.lua:10 in load_extension
• telescope.nvim\lua\telescope_extensions\init.lua:62 in load_extension
• lua/{ME}/plugins/telescope.lua:25 in config
• lua/{ME}/lazy.lua:14
• init.lua:4

用户配置代码 #

return {
'nvim-telescope/telescope.nvim', tag = '0.1.4',
dependencies = { 
    'nvim-lua/plenary.nvim',
{'nvim-telescope/telescope-fzf-native.nvim', build = "make" },
    "nvim-tree/nvim-web-devicons",
},
config = function() 
local telescope = require("telescope")
    local actions = require("telescope.actions")

    telescope.setup({
    defaults = {
    path_display = { "truncate "},
    mappings = {
    i = {
    ["<C-k>"] = actions.move_selection_previous,
    ["<C-j>"] = actions.move_selection_next,
    ["<C-q>"] = actions.send_selected_to_qflist + actions.open_qflist,
    },
    },
    },
})

telescope.load_extension("fzf")

local keymap = vim.keymap 

keymap.set("n", "<leader>ff", "<cmd>Telescope find_files<cr>", {desc = "Fuzz find files in cwd" })
keymap.set("n", "<leader>fr", "<cmd>Telescope oldfiles<cr>", { desc = "Fuzzy find recent files" })
    keymap.set("n", "<leader>fs", "<cmd>Telescope live_grep<cr>", { desc = "Find string in cwd" })
    keymap.set("n", "<leader>fc", "<cmd>Telescope grep_string<cr>", { desc = "Find string under cursor in cwd" })
end,

}

核心原因 #

Windows环境默认没有安装GNU Make工具，你配置中用build = "make"编译telescope-fzf-native.nvim会失败，导致无法生成libfzf.dll，最终加载扩展时找不到该模块。另外:checkhealth telescope仅检查扩展是否注册，不会验证编译后的动态链接库是否存在，因此出现健康检查正常但实际加载失败的矛盾情况。

解决步骤 #

1. 替换Windows兼容的编译命令 #

修改Telescope配置中telescope-fzf-native.nvim的build参数，改用CMake编译（Windows环境通常已预装或可通过包管理工具安装CMake）：

{'nvim-telescope/telescope-fzf-native.nvim', build = 'cmake -S. -Bbuild -DCMAKE_BUILD_TYPE=Release && cmake --build build --config Release && cmake --install build --prefix build' },

2. 重新编译插件 #

在Neovim中执行以下命令：

• :Lazy clean：删除已安装的telescope-fzf-native.nvim
• :Lazy install：重新安装并编译插件

3. 验证修复 #

重启Neovim，确认错误是否消失；也可手动检查C:/Users/{ME}/AppData/Local/nvim-data/lazy/telescope-fzf-native.nvim/build目录下是否生成了libfzf.dll文件。

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