Neovim中GoToBuffer函数按键映射报错：参数异常求助

错误原因 #

1. 按键绑定格式错误：<cmd>:lua ...中多了一个冒号，<cmd>前缀已代表执行Ex命令，后续直接跟lua命令即可，多余的冒号会导致Lua解析失败。
2. 函数未导出：GoToBuffer是autoload/utils.lua中的局部函数（local function），未暴露给模块外部，require后无法调用该函数。
3. 废弃API使用：vim.tbl_index是Neovim旧版本函数，当前版本已废弃，会引发运行时错误。
4. 逻辑遗漏：原代码中当count不为0时，仅处理了forward方向的buffer跳转，backward方向无对应逻辑。

修复步骤 #

1. 修改autoload/utils.lua，导出函数并修复API使用 #

将局部函数改为模块导出函数，替换废弃API，补全逻辑：

local M = {}

local function GetBufNums()
    local buf_list = {}
    for _, buf in ipairs(vim.api.nvim_get_buf_info({ buflisted = 1 })) do
        buf_list[#buf_list + 1] = buf.bufnr
    end
    return buf_list
end

function M.GoToBuffer(count, direction)
    if count == 0 then
        if direction == "forward" then
            vim.api.nvim_command("bnext")
        elseif direction == "backward" then
            vim.api.nvim_command("bprevious")
        else
            vim.api.nvim_err_writeln("Bad argument " .. direction)
        end
        return
    end

    local buf_nums = GetBufNums()
    -- 替换废弃的vim.tbl_index，检查count是否为有效buffer编号
    local is_valid = false
    for _, num in ipairs(buf_nums) do
        if num == count then
            is_valid = true
            break
        end
    end

    if not is_valid then
        vim.fn.nvim_notify(string.format("Invalid bufnr: %d", count), 4, { title = "nvim-config" })
        return
    end

    -- 统一处理count不为0时的buffer跳转，无需区分方向
    vim.api.nvim_command(string.format("buffer %d", count))
end

return M

2. 修正按键绑定代码 #

去掉<cmd>后的多余冒号，推荐使用Lua函数直接绑定（避免字符串解析问题）：

local keymap = vim.keymap
local utils = require('autoload.utils')

-- 推荐写法：直接绑定Lua函数，更可靠
keymap.set("n", "gb", function()
    utils.GoToBuffer(vim.v.count, "forward")
end, { noremap = true, silent = true })

keymap.set("n", "gB", function()
    utils.GoToBuffer(vim.v.count, "backward")
end, { noremap = true, silent = true })

-- 若坚持使用<cmd>字符串写法，需去掉多余冒号：
-- keymap.set("n", "gb", '<cmd>lua utils.GoToBuffer(v:count, "forward")<cr>', { noremap = true, silent = true })
-- keymap.set("n", "gB", '<cmd>lua utils.GoToBuffer(v:count, "backward")<cr>', { noremap = true, silent = true })

额外优化 #

• 添加noremap = true和silent = true到按键绑定选项，避免递归映射并抑制命令输出，提升使用体验。
• 当count不为0时，跳转逻辑无需区分方向，直接切换到指定编号的buffer即可，简化代码逻辑。

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