Neovim nvim-lspconfig 中 hover 边框不显示问题分析与解决方案

问题背景

在使用 Neovim 的 nvim-lspconfig 插件时，部分用户发现通过 vim.lsp.buf.hover() 调用悬浮窗口时，配置的边框样式无法正常显示。该问题主要出现在 Neovim 0.11.0-dev 版本中，用户尝试通过以下两种方式配置边框均未生效：

1. 通过 LSP handlers 全局配置：

local handlers = {
  ["textDocument/hover"] = vim.lsp.with(vim.lsp.handlers.hover, { border = "rounded" })
}

2. 调用时直接传入参数：

vim.lsp.buf.hover({ border = "rounded" })

根本原因

经过社区排查，发现该问题主要由两个因素导致：

1. Neovim 0.11.0-dev 的行为变更：新版本中 vim.lsp.buf.hover() 不再触发全局 handlers，而是直接处理多个客户端的结果。这一变更使得通过 handlers 配置的边框样式失效。

2. 插件冲突：部分用户使用的 Noice 插件会覆盖默认的悬浮窗口渲染方式，导致边框设置被忽略。

解决方案

方案一：直接调用时指定参数（推荐）

-- 绑定快捷键时直接指定边框样式
vim.keymap.set('n', 'K', function()
  vim.lsp.buf.hover({ border = "rounded" })
end)

方案二：禁用冲突插件

如果使用了 Noice 等可能影响悬浮窗口渲染的插件，可以通过以下配置禁用其对 hover 的处理：

require('noice').setup({
  lsp = {
    hover = { enabled = false }  -- 禁用 Noice 对 hover 的接管
  }
})

方案三：降级 Neovim 版本

对于依赖旧版行为的用户，可以暂时使用 Neovim 0.10.x 稳定版本，等待相关生态适配完成。

技术原理补充

Neovim 的 LSP 悬浮窗口渲染经历了以下演进：

1. 早期版本通过全局 handlers 统一处理所有 LSP 响应
2. 新版本改为客户端独立处理，支持多客户端结果合并
3. 边框等样式属性现在需要直接传递给具体的窗口创建函数

这种架构变更带来了更好的灵活性，但也需要用户调整原有的配置方式。理解这一变化有助于更好地适应未来 Neovim LSP 生态的发展。

最佳实践建议

1. 对于新项目，推荐采用方案一的直接传参方式
2. 保持插件更新，及时关注 Neovim 的变更日志
3. 复杂场景下可以考虑封装自定义 hover 函数，统一处理样式和异常