Neovim lspconfig打开关联LSP的文件时nvim_multiline_command报nil值错误

云原生阿岚

2026-11-6

报错根因

代码中调用的 require('lspconfig').util.nvim_multiline_command 是 lspconfig 早期版本的已废弃内部工具函数，此前老版本仍保留该非公开接口时可以正常运行，后续版本清理内部工具、完全移除该定义后，调用时就会触发nil值报错。
配套使用的 client.resolved_capabilities 是Neovim 0.8版本前的旧LSP客户端API，当前版本已将该字段替换为 client.server_capabilities，属于同步过时的配置。

修复方案

移除对已废弃内部工具的依赖，直接使用Neovim原生Lua API实现同等的文档高亮逻辑，不再绑定lspconfig的非公开接口，避免后续版本迭代再触发兼容问题。
将旧的服务能力判断字段替换为当前官方支持的字段，消除API废弃警告。

可用的替换代码

if client.server_capabilities.documentHighlightProvider then
  -- 定义引用高亮样式
  vim.api.nvim_set_hl(0, 'LspReferenceRead', { cterm = { bold = true, bg = 'red' }, guibg = 'LightYellow' })
  vim.api.nvim_set_hl(0, 'LspReferenceText', { cterm = { bold = true, bg = 'red' }, guibg = 'LightYellow' })
  vim.api.nvim_set_hl(0, 'LspReferenceWrite', { cterm = { bold = true, bg = 'red' }, guibg = 'LightYellow' })

  -- 初始化自动命令组
  local augroup = vim.api.nvim_create_augroup('lsp_document_highlight', { clear = true })

  -- 注册缓冲区级自动命令
  vim.api.nvim_create_autocmd('CursorHold', {
    buffer = bufnr,
    group = augroup,
    callback = vim.lsp.buf.document_highlight,
  })
  vim.api.nvim_create_autocmd('CursorMoved', {
    buffer = bufnr,
    group = augroup,
    callback = vim.lsp.buf.clear_references,
  })
end