NvChad中如何自定义LSP悬浮窗口的边框样式

在Neovim配置框架NvChad中，LSP(Language Server Protocol)相关的悬浮窗口(如诊断信息、函数签名提示等)默认会显示边框。本文将详细介绍如何根据个人喜好自定义这些边框的显示方式。

边框控制的基本原理

在Neovim 0.11及以上版本中，窗口边框主要通过winborder选项控制。这个选项可以设置为"none"来完全禁用边框，或者设置为"single"、"double"、"rounded"等来显示不同样式的边框。

对于LSP相关的悬浮窗口，边框控制主要涉及三个部分：

1. 代码补全窗口(通过nvim-cmp配置)
2. 诊断信息浮动窗口
3. LSP悬浮提示窗口(包括函数签名帮助)

配置方法详解

1. 代码补全窗口边框配置

代码补全窗口的边框可以通过nvim-cmp的配置来控制：

local cmp = require("cmp")
cmp.setup({
    window = {
        completion = cmp.config.window.bordered({
            border = "none",  -- 设置为"none"禁用边框
            winhighlight = "Normal:CmpPmenu,CursorLine:PmenuSel,Search:None",
        }),
        documentation = cmp.config.window.bordered({
            border = "none",  -- 设置为"none"禁用边框
            winhighlight = "Normal:CmpPmenu,CursorLine:PmenuSel,Search:None",
        }),
    },
})

2. 诊断信息浮动窗口配置

诊断信息的浮动窗口可以通过vim.diagnostic.config来配置：

vim.diagnostic.config({
    virtual_text = { prefix = "" },
    signs = { text = { [x.ERROR] = "󰅙", [x.WARN] = "", [x.INFO] = "󰋼", [x.HINT] = "󰌵" } },
    underline = true,
    float = { 
        border = "none",  -- 设置为"none"禁用边框
        header = ""       -- 同时可以移除诊断信息的标题
    },
})

3. LSP悬浮提示窗口配置

对于LSP的悬浮提示(通过K键触发)和函数签名帮助，可以通过以下方式配置：

-- 配置悬浮提示窗口
vim.keymap.set({ "n" }, "K", function()
    vim.lsp.buf.hover { border = "rounded" }  -- 可以设置为"single"、"double"等
end, { desc = "LSP show details", silent = true })

-- 全局配置所有LSP浮动窗口的边框
local orig_util_open_floating_preview = vim.lsp.util.open_floating_preview
function vim.lsp.util.open_floating_preview(contents, syntax, opts, ...)
    opts = opts or {}
    opts.border = "rounded"  -- 设置默认边框样式
    return orig_util_open_floating_preview(contents, syntax, opts, ...)
end

高级自定义技巧

如果需要更精细的控制，可以使用自动命令来动态修改窗口属性：

-- 自动移除所有浮动窗口的边框
vim.api.nvim_create_autocmd({ "WinNew", "BufWinEnter" }, {
    callback = function()
        for _, win in ipairs(vim.api.nvim_list_wins()) do
            local cfg = vim.api.nvim_win_get_config(win)
            if cfg.relative ~= "" then -- 判断是否为浮动窗口
                pcall(vim.api.nvim_win_set_config, win, { border = "none" })
            end
        end
    end,
})

-- 针对LSP签名帮助窗口的特殊处理
vim.api.nvim_create_autocmd("User", {
    pattern = "LspSignatureHelpOpened",
    callback = function()
        vim.defer_fn(function() -- 等待一帧
            local win = vim.fn.bufwinid(vim.fn.bufnr())
            pcall(vim.api.nvim_win_set_config, win, { border = "none" })
        end, 10)
    end,
})

注意事项

1. 在Neovim 0.11及以上版本中，建议使用vim.o.winborder来全局控制窗口边框
2. 不同版本的Neovim可能有不同的边框控制机制，请根据实际使用的版本来调整配置
3. 全局设置winborder会影响所有窗口(包括插件窗口如Lazy、Telescope等)，使用时需谨慎

通过以上配置，用户可以灵活地控制NvChad中LSP相关窗口的边框显示，打造符合个人喜好的编辑环境。