Windows环境下Neovim无法启动clangd LSP服务器的配置问题

clangd LSP完全不启动是两个问题导致的：

• Visual Studio 2022自带的LLVM/clang组件默认不会把可执行文件路径加入系统环境变量，nvim-lspconfig找不到clangd.exe就不会启动服务，默认也不会弹出显性错误提示
• CMake项目默认不会导出compile_commands.json编译数据库，就算clangd启动了，没有这个文件也没法正确识别项目的头文件搜索路径、宏定义、编译参数，功能完全无法正常使用

1. 配置clangd可执行文件路径 #

VS2022安装的clangd默认路径为（根据你的VS版本、安装盘符、发行版（Community/Professional/Enterprise）调整）：
C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\Llvm\x64\bin\
你可以选两种方式配置：

• 方案一（推荐）：把上面的bin目录加入系统PATH环境变量，加完开新终端执行clangd --version能正常输出版本号即为生效
• 方案二：不想改系统环境变量的话，直接在Neovim配置里写死clangd.exe的绝对路径

注意：修改完系统环境变量必须完全关闭所有Neovim窗口重开，Neovim只会读取启动时继承的环境变量，不重开依然会找不到clangd。

2. 配置CMake自动导出编译数据库 #

你使用的vim-cmake插件支持自动链接编译数据库到项目根目录，只需要在配置里加一行：

vim.g.cmake_link_compile_commands = 1

加完之后执行:CMakeGenerate生成项目时，会自动把构建目录下的compile_commands.json软链接到项目根目录，clangd启动时会自动读取这个文件获取项目编译参数。
如果不用插件，手动执行CMake生成命令时加上-DCMAKE_EXPORT_COMPILE_COMMANDS=1参数也能实现同样效果。

3. 修改LSP配置适配Windows+VS环境 #

把你原来init.lua里循环配置LSP服务器的部分替换为下面的代码，针对clangd加专门的适配参数：

local servers = { 'pyright', 'clangd' }
for _, lsp in pairs(servers) do
  local server_config = {
    on_attach = on_attach,
    flags = {
      debounce_text_changes = 150
    }
  }

  if lsp == 'clangd' then
    -- 如果没把clangd加入系统PATH，取消下面一行注释，替换为你本机的clangd.exe绝对路径
    -- server_config.cmd = { "C:\\Program Files\\Microsoft Visual Studio\\2022\\Community\\VC\\Tools\\Llvm\\x64\\bin\\clangd.exe" }
    
    -- clangd启动参数，适配Windows MSVC环境
    local clangd_args = {
      "--background-index",
      "--clang-tidy",
      "--completion-style=detailed",
      "--header-insertion=iwyu",
      "--query-driver=clang-cl.exe,cl.exe"
    }
    server_config.cmd = server_config.cmd or { "clangd" }
    vim.list_extend(server_config.cmd, clangd_args)
  end

  require('lspconfig')[lsp].setup(server_config)
end

-- CMake自动链接编译数据库配置
vim.g.cmake_link_compile_commands = 1

其中--query-driver参数必须加，不然clangd会找不到MSVC和clang-cl的标准库头文件路径，报一堆不存在的错误。

4. 验证生效 #

配置改完重启Neovim，打开C++源文件后执行：

• :LspInfo：可以查看当前缓冲区附加的LSP服务，clangd显示在已附加列表里就说明服务启动成功
• :checkhealth lspconfig：如果还是没启动，执行这个命令会直接输出具体错误原因，比如找不到可执行文件、权限问题等
  第一次打开项目时clangd会做全量项目索引，等状态栏索引进度跑完就能正常使用补全、跳转、代码诊断、重命名等LSP功能。

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