LunarVim/Launch.nvim项目中Lua LSP类型错误问题分析与解决方案

问题背景

在LunarVim/Launch.nvim项目中使用Lua语言服务器协议(LSP)时，用户遇到了一个类型错误问题。当尝试编辑Lua文件时，系统抛出错误提示："expected boolean, got number"。这个错误发生在vim.lsp.inlay_hint模块的enable函数中，表明在启用inlay hints功能时传入了错误的参数类型。

技术分析

inlay hints是LSP提供的一项功能，它可以在代码中显示额外的类型信息或参数提示。在Neovim中，这个功能通过vim.lsp.inlay_hint模块实现。错误信息表明enable函数期望接收一个布尔值参数，但实际收到了数字类型。

深入分析发现，问题根源在于LSP配置文件中on_attach回调函数的实现方式。在旧版本中，可能存在直接将数字值传递给enable函数的情况，而新版本的API要求严格的布尔值参数。

解决方案

经过社区验证，以下修改方案可以有效解决问题：

1. 修改on_attach函数实现：

M.on_attach = function(client, bufnr) 
  lsp_keymaps(bufnr)

  if client.supports_method "textDocument/inlayHint" then
    vim.lsp.inlay_hint.enable(true, { bufnr })
  end
end

2. 更新toggle_inlay_hints函数：

M.toggle_inlay_hints = function()
  local bufnr = vim.api.nvim_get_current_buf()
  vim.lsp.inlay_hint.enable(not vim.lsp.inlay_hint.is_enabled({ bufnr }), { bufnr })
end

技术要点

1. 参数类型检查：确保传递给enable函数的是布尔值而非数字
2. 功能检测：通过supports_method检查客户端是否支持inlay hints功能
3. 缓冲区管理：明确指定操作的目标缓冲区

最佳实践建议

1. 在使用LSP功能时，始终检查客户端支持的能力
2. 注意API变更，特别是参数类型的严格要求
3. 为LSP功能添加适当的错误处理机制
4. 保持LSP相关插件和Neovim版本的同步更新

这个问题反映了LSP实现细节变化带来的兼容性问题，也提醒开发者在自定义LSP配置时需要关注API变更和参数类型检查。