Neovim中LSP无法附着到缓冲区的问题求助

问题现象 #

• 直接复制kickstart.nvim默认配置未做修改，但LSP始终无法附着到任何缓冲区
• 执行:LspInfo显示0 client(s) attached to this buffer，且Configured servers list为空
• 通过:Mason确认已安装astro-language-server、clangd、lua_ls等多语言服务器

排查与解决步骤 #

1. 补全cmp_nvim_lsp依赖 #

配置片段中使用了require('cmp_nvim_lsp').default_capabilities()扩展LSP能力，但当前nvim-lspconfig的依赖列表中未包含该插件，会导致LSP初始化失败。需要在依赖中添加：

dependencies = {
  'williamboman/mason.nvim',
  'williamboman/mason-lspconfig.nvim',
  'WhoIsSethDaniel/mason-tool-installer.nvim',
  { 'j-hui/fidget.nvim', opts = {} },
  { 'folke/neodev.nvim', opts = {} },
  'hrsh7th/cmp-nvim-lsp', -- 新增此依赖
},

2. 验证mason-lspconfig的服务器映射逻辑 #

当前配置中servers表定义了clangd、pyright等服务器，mason-tool-installer会自动安装这些服务器，但需确保：

• 服务器名称拼写正确（比如Lua服务器是lua_ls而非lua-language-server）
• mason-lspconfig的handler函数能正确遍历servers表并初始化每个服务器

3. 查看LSP日志定位具体错误 #

查看LSP日志文件/Users/jgs/.local/state/nvim/lsp.log，搜索error或failed关键词，常见问题包括：

• 服务器可执行文件路径错误
• 服务器配置格式错误（比如lua_ls的settings结构问题）
• 服务器依赖的外部工具缺失

4. 手动测试单个服务器初始化 #

在Neovim命令行执行以下代码，手动启动lua_ls服务器，直接查看报错信息：

:lua require('lspconfig').lua_ls.setup({})

如果初始化失败，终端会输出具体错误，帮助快速定位问题。

5. 确认LSP启动触发条件 #

确保打开的文件类型与已安装的服务器匹配（比如打开.lua文件对应lua_ls），部分服务器需要特定的项目根文件（比如pyright需要pyproject.toml或requirements.txt）才会启动。

内容的提问来源于stack exchange，提问作者unnamed-dev