从VSCode转Neovim：配置nvim-cmp缺失函数参数提示求助

1. 补充依赖插件 #

要实现VSCode式的参数提示和文档查看，你需要给nvim-cmp搭配以下插件（以packer.nvim为例）：

use {
  'hrsh7th/nvim-cmp',
  requires = {
    'hrsh7th/cmp-nvim-lsp',          -- 对接LSP的补全能力
    'hrsh7th/cmp-nvim-lsp-signature-help', -- 提供函数参数签名提示
    'neovim/nvim-lspconfig'          -- LSP基础配置插件
  }
}

如果用lazy.nvim，写法类似，把这些插件加入你的插件列表即可。

2. 配置LSP支持 #

在你的LSP服务配置中，必须将nvim-cmp的能力传递给LSP，这样LSP才能把参数、文档信息推送给nvim-cmp：

local cmp_capabilities = require('cmp_nvim_lsp').default_capabilities()

-- 以Python的pyright为例，其他LSP如tsserver、clangd配置同理
require('lspconfig').pyright.setup({
  capabilities = cmp_capabilities
})

3. 调整nvim-cmp核心配置 #

修改你的nvim-cmp设置，添加签名提示源并启用文档窗口：

local cmp = require('cmp')

cmp.setup({
  sources = cmp.config.sources({
    { name = 'nvim_lsp' },
    { name = 'nvim_lsp_signature_help' }, -- 启用参数签名提示源
    -- 保留你原来的其他源，比如buffer、path等
  }),
  -- 启用带边框的文档窗口，更接近VSCode体验
  window = {
    documentation = cmp.config.window.bordered(),
    completion = cmp.config.window.bordered()
  },
  mapping = cmp.mapping.preset.insert({
    ['<C-k>'] = cmp.mapping.scroll_docs(-4), -- 向上滚动文档
    ['<C-j>'] = cmp.mapping.scroll_docs(4),  -- 向下滚动文档
    ['<CR>'] = cmp.mapping.confirm({ select = true }),
    -- 保留你原来的其他映射
  })
})

配置完成后，输入函数括号时会自动弹出参数签名提示；选中补全项时，右侧会显示函数文档，也可以用<C-k>/<C-j>滚动查看详细内容。

4. 可选：更贴合VSCode的参数提示 #

如果想要实时高亮当前输入的参数，可以安装ray-x/lsp_signature.nvim插件：

-- packer写法
use 'ray-x/lsp_signature.nvim'

然后添加初始化配置：

require('lsp_signature').setup({
  bind = true,
  floating_window = true,
  hint_enable = true,
  handler_opts = {
    border = 'rounded'
  }
})

这个插件会在你输入参数时，动态显示当前参数的位置，完全复刻VSCode的参数提示体验。

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