如何使用Telescope的previewers函数？git_commit_diff_to_head调用报错求助

核心问题本质 #

git_commit_diff_to_head是Telescope的预览器构造函数，不能直接调用执行，它需要被实例化后作为参数传入对应的Telescope picker（比如bcommits），依赖picker提供的上下文（如$SHA、$CURRENT_FILE变量）才能正常工作。

正确配置方案 #

1. 为bcommits绑定自定义预览器 #

在init.lua中通过Telescope的setup方法，给bcommits picker指定该预览器，同时保留自定义命令模板：

require('telescope').setup({
  pickers = {
    bcommits = {
      previewer = require('telescope.previewers').git_commit_diff_to_head.new({
        command = "git --no-pager diff --cached $SHA -- $CURRENT_FILE"
      })
    }
  }
})

2. 配套按键映射（可选） #

如果需要快速触发配置好的bcommits，可以设置全局映射，还能手动指定当前文件路径：

vim.keymap.set('n', '<leader>gb', function()
  require('telescope.builtin').bcommits({
    path = vim.fn.expand('%:p') -- 强制传入当前文件，留空则由Telescope自动判断
  })
end, { desc = 'Telescope: 浏览当前缓冲区提交记录' })

常见错误原因 #

• 直接调用git_commit_diff_to_head()：该函数是构造器，必须用.new()实例化后传入picker，单独执行会因缺少上下文变量报错。
• 未绑定到对应picker：预览器依赖picker提供的$SHA（提交哈希）和$CURRENT_FILE（当前文件路径）变量，全局调用或单独映射无法提供这些参数。

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