nvim-cmp悬浮文档窗口边框配置指南

在Neovim生态系统中，nvim-cmp作为一款强大的自动补全插件，其悬浮文档窗口的边框显示问题可能会影响用户体验。本文将深入探讨如何正确配置悬浮文档窗口的边框显示，并分享一些实用的配置技巧。

问题现象分析

许多用户在使用nvim-cmp时发现，虽然已经按照文档配置了窗口边框，但悬浮文档窗口的边框却无法正常显示。这种情况通常发生在同时使用noice.nvim插件时，因为noice.nvim接管了LSP相关的悬浮窗口渲染。

基础配置方案

在纯nvim-cmp环境下，悬浮文档窗口的边框可以通过以下配置实现：

cmp.setup({
  window = {
    completion = cmp.config.window.bordered(),
    documentation = cmp.config.window.bordered(),
  },
})

这种配置方式简单直接，适用于不涉及其他悬浮窗口管理插件的基础环境。

与noice.nvim的集成方案

当系统中同时使用noice.nvim时，需要特别注意其对LSP相关悬浮窗口的控制。以下是完整的集成配置方案：

require("noice").setup({
  lsp = {
    documentation = {
      view = "hover",
      opts = {
        lang = "markdown",
        replace = true,
        render = "plain",
        format = { "{message}" },
        position = { row = 2, col = 2 },
        size = {
          max_width = math.floor(0.8 * vim.api.nvim_win_get_width(0)),
          max_height = 15,
        },
        border = {
          style = "rounded",
        },
        win_options = {
          concealcursor = "n",
          conceallevel = 3,
          winhighlight = {
            Normal = "CmpPmenu",
            FloatBorder = "DiagnosticSignInfo",
          },
        },
      },
    },
  },
})

关键配置解析

1. 窗口尺寸控制：使用math.floor确保宽度值为整数，避免因浮点数计算导致的窗口创建错误。

2. 边框样式：通过border.style可以设置多种边框样式，如"single"、"double"、"rounded"等。

3. 高亮配置：winhighlight允许自定义窗口不同部分的高亮组，确保与整体主题协调。

高级优化技巧

1. 响应式宽度调整：结合vim的autocmd，可以在窗口大小变化时动态调整悬浮文档窗口的最大宽度：

vim.api.nvim_create_autocmd("VimResized", {
  callback = function()
    require("noice").setup({
      lsp = {
        documentation = {
          opts = {
            size = {
              max_width = math.floor(0.8 * vim.api.nvim_win_get_width(0)),
            },
          },
        },
      },
    })
  end,
})

2. 内容格式化：对于Markdown文档，可以配置更丰富的渲染选项：

format = {
  "{message}",
  "────────────────────",
  "_{source}_",
},

3. 性能优化：对于大型文档，可以限制最大高度并启用滚动：

size = {
  max_width = math.floor(0.8 * vim.api.nvim_win_get_width(0)),
  max_height = 20,  -- 限制最大行数
},

常见问题解决方案

1. 边框不显示：检查是否有其他插件接管了悬浮窗口的渲染，特别是noice.nvim或lspsaga等插件。

2. 窗口位置偏移：调整position参数中的row和col值，确保窗口出现在理想位置。

3. 内容截断：适当增加max_width和max_height值，或检查文档内容是否包含特殊字符导致渲染异常。

通过以上配置和技巧，用户可以打造既美观又实用的nvim-cmp悬浮文档窗口，提升代码补全和文档查阅的整体体验。