nvim-cmp 中处理 clangd 长函数原型显示问题

问题背景

在使用 nvim-cmp 插件配合 clangd 语言服务器进行 C++ 开发时，开发者经常会遇到一个显示问题：自动补全菜单中会显示完整的函数原型，导致补全窗口变得异常冗长，影响开发体验和界面美观。

问题分析

clangd 语言服务器默认会提供完整的函数签名信息作为补全项的附加说明，这在某些情况下确实有帮助，但当函数参数较多时，会导致补全窗口显示过长。nvim-cmp 作为补全引擎，会如实显示语言服务器提供的所有信息。

解决方案

通过修改 nvim-cmp 的格式化配置，我们可以控制这些额外信息的显示。核心思路是自定义格式化函数，在显示前对补全项进行处理。

具体实现方法

在 nvim-cmp 的配置中，我们可以使用 formatting.format 选项来自定义显示内容。以下是一个有效的配置示例：

formatting = {
    format = require("lspkind").cmp_format({
        mode = "symbol_text",
        maxwidth = 50,          -- 设置最大显示宽度
        ellipsis_char = "...",  -- 超长内容显示省略符
        
        -- 自定义处理函数
        before = function(_, vim_item)
            -- 针对clangd来源的补全项，清空menu字段
            vim_item.menu = ({ nvim_lsp = "" })["clangd"]
            return vim_item
        end,
    }),
}

配置说明

1. maxwidth：限制补全项的最大显示宽度，超出部分会被截断
2. ellipsis_char：指定截断时显示的省略符号
3. before函数：在最终格式化前对补全项进行处理，这里我们特别处理了来自clangd的补全项，清空了其menu字段

效果对比

应用此配置后：

• 原本可能占据多行的冗长函数签名将不再显示
• 补全窗口保持紧凑，只显示最关键的补全信息
• 仍然保留了符号类型等有用信息

进阶建议

对于需要更精细控制的开发者，还可以考虑：

1. 根据上下文决定是否显示完整签名
2. 保留关键参数信息而省略细节
3. 使用不同的视觉样式区分不同类型的补全项

总结

通过合理配置 nvim-cmp 的格式化选项，开发者可以有效控制 clangd 提供的补全信息显示方式，在保持功能完整性的同时优化界面体验。这种方法不仅适用于 clangd，也可以推广到其他语言服务器的配置中。