基于craftzdog配置Neovim遇init_lsp_saga nil值错误求解决

配置craftzdog的dotfiles后，Neovim启动时出现LspSaga相关错误，报错信息：

attempt to call field 'init_lsp_saga' (a nil value)

对应lspsaga.rc.lua原配置：

local status, saga = pcall(require, "lspsaga")
if (not status) then return end

saga.init_lsp_saga {
  server_filetype_map = {
    typescript = 'typescript'
  }
}

local opts = { noremap = true, silent = true }
vim.keymap.set('n', '<C-j>', '<Cmd>Lspsaga diagnostic_jump_next<CR>', opts)
vim.keymap.set('n', 'K', '<Cmd>Lspsaga hover_doc<CR>', opts)
vim.keymap.set('n', 'gd', '<Cmd>Lspsaga lsp_finder<CR>', opts)
-- vim.keymap.set('i', '<C-k>', '<Cmd>Lspsaga signature_help<CR>', opts)
vim.keymap.set('i', '<C-k>', '<cmd>lua vim.lsp.buf.signature_help()<CR>', opts)
vim.keymap.set('n', 'gp', '<Cmd>Lspsaga peek_definition<CR>', opts)
vim.keymap.set('n', 'gr', '<Cmd>Lspsaga rename<CR>', opts)

核心原因 #

LspSaga版本迭代后初始化API发生变更：旧版的init_lsp_saga方法已被移除，新版本统一使用setup方法完成配置初始化。

修改步骤 #

将配置中的saga.init_lsp_saga替换为saga.setup，参数结构保持不变即可。若后续仍有命令报错，需检查是否是命令名称的版本适配问题（比如部分命令前缀或子命令名称有更新）。

修改后的完整配置：

local status, saga = pcall(require, "lspsaga")
if (not status) then return end

-- 替换init_lsp_saga为setup
saga.setup {
  server_filetype_map = {
    typescript = 'typescript'
  }
}

local opts = { noremap = true, silent = true }
vim.keymap.set('n', '<C-j>', '<Cmd>Lspsaga diagnostic_jump_next<CR>', opts)
vim.keymap.set('n', 'K', '<Cmd>Lspsaga hover_doc<CR>', opts)
vim.keymap.set('n', 'gd', '<Cmd>Lspsaga lsp_finder<CR>', opts)
-- vim.keymap.set('i', '<C-k>', '<Cmd>Lspsaga signature_help<CR>', opts)
vim.keymap.set('i', '<C-k>', '<cmd>lua vim.lsp.buf.signature_help()<CR>', opts)
vim.keymap.set('n', 'gp', '<Cmd>Lspsaga peek_definition<CR>', opts)
vim.keymap.set('n', 'gr', '<Cmd>Lspsaga rename<CR>', opts)

若替换后部分命令仍无法正常工作，可核对当前LspSaga版本的官方说明，确认命令名称是否有调整。

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