Neovim使用Lazy.nvim时LSP诊断虚拟文本与符号不显示问题

可能原因及修复步骤 #

1. 检查全局诊断配置是否启用 #

确保Neovim核心诊断选项已开启，在配置中添加或确认以下设置：

vim.diagnostic.config({
  virtual_text = true, -- 启用内联虚拟文本提示
  signs = true, -- 启用侧边栏诊断符号
  underline = true, -- 用下划线标注诊断位置
  update_in_insert = false, -- 插入模式下不更新诊断（避免干扰输入）
  severity_sort = true, -- 按严重程度排序诊断信息
})

2. 确认LSP客户端的诊断发布权限 #

部分语言服务器可能会覆盖全局配置，需在LSP初始化时显式启用诊断功能：

local on_attach = function(client, bufnr)
  -- 确保客户端支持诊断发布能力
  client.server_capabilities.documentDiagnosticProvider = true
  -- 可针对当前缓冲区单独配置诊断显示
  vim.diagnostic.config({ virtual_text = true }, bufnr)
end

-- 在LSP服务配置中传入on_attach
require("lspconfig").lua_ls.setup({
  on_attach = on_attach,
  -- 其他LSP配置项...
})

3. 调整Lazy.nvim插件加载顺序 #

Lazy.nvim的加载顺序可能影响配置生效，确保诊断配置在nvim-lspconfig之后加载：

return {
  "neovim/nvim-lspconfig",
  config = function()
    -- 先配置全局诊断规则
    vim.diagnostic.config({...})
    -- 再初始化语言服务器
    require("lspconfig").[你的语言服务器].setup({...})
  end,
}

4. 排查插件冲突 #

部分UI美化或自定义诊断插件可能覆盖默认显示逻辑，暂时禁用非必要插件，逐一排查是否存在冲突。

5. 检查LSP健康状态 #

运行:checkhealth lsp查看LSP服务的运行状态，确认是否存在诊断相关的报错或能力缺失。

调试验证步骤 #

• 运行:lua print(vim.inspect(vim.diagnostic.config()))，查看当前诊断配置中virtual_text和signs是否为true
• 运行:LspInfo，确认目标语言服务器已正常启动且支持诊断能力
• 手动触发测试诊断：:lua vim.diagnostic.set({ severity = vim.diagnostic.severity.ERROR }, 0, { message = "测试错误提示" })，检查是否显示虚拟文本

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