MacOS下Telescope.nvim配置运行失败问题求助

算力阿峰

2026-6-26

解决Telescope.nvim配置时Failed to run config for telescope.nvim错误

核心错误原因

当前报错的直接触发点是你的telescope.lua配置文件第20行引用了未定义的全局变量custom_actions，和你之前折腾的telescope-fzf-native.nvim构建操作无关——你之前的操作都没触及这个配置代码问题，所以一直无法解决。

分步解决方案

1. 修复未定义变量问题

你配置里用到了custom_actions.open_trouble_qflist，分两种情况处理：

如果确实需要这个功能（关联trouble.nvim打开快速修复列表）：
先确保已安装trouble.nvim插件，然后在telescope.lua的配置代码前，补充定义custom_actions：

-- 先导入trouble模块
local trouble = require("trouble")
-- 自定义动作定义
local custom_actions = {}
custom_actions.open_trouble_qflist = function(prompt_bufnr)
  require("telescope.actions").send_to_qflist(prompt_bufnr)
  trouble.open("quickfix")
end

之后再继续你的Telescope配置代码。

如果不需要这个功能：
直接删掉telescope.lua中所有引用custom_actions.open_trouble_qflist的代码行即可。

2. 处理telescope-fzf-native的构建（避免后续潜在问题）

虽然这不是当前报错的原因，但确保构建成功能让fzf优化生效：

先确认MacOS已安装Xcode命令行工具：
```
xcode-select --install
```
在Lazy插件管理器的telescope-fzf-native.nvim配置中保留build = "make"，然后执行：
```
:Lazy build telescope-fzf-native.nvim
```
或者直接到插件目录手动构建：
```
cd ~/{user}/.local/share/nvim/lazy/telescope-fzf-native.nvim
make
```

3. 修复Telescope健康检查的问题

根据你提供的健康检查结果，补全依赖提升Telescope体验：

安装nvim-treesitter：
在你的Lazy插件配置中添加：

{
  "nvim-treesitter/nvim-treesitter",
  build = ":TSUpdate",
  config = function()
    require("nvim-treesitter.configs").setup({
      ensure_installed = { "lua", "vim" }, -- 按需添加你需要的语言
      highlight = { enable = true }
    })
  end
}