clangd无法识别标准头文件，nvim LSP配置问题求助

原因排查与解决方案 #

1. 安装标准库开发依赖 #

Ubuntu下clangd需要对应标准库的头文件支持，先确保安装必要依赖包：

sudo apt update && sudo apt install libstdc++-dev libc++-dev

前者是g使用的GNU标准库，后者是clang原生的LLVM标准库，由于你编译时用的是g，优先保证libstdc++-dev安装到位。

2. 让clangd匹配编译用的g++驱动 #

clangd默认可能无法自动关联g的标准库路径，需要在nvim的LSP配置中添加--query-driver参数，强制clangd复用g的编译环境：

如果使用nvim-lspconfig配置clangd，修改配置如下：

require('lspconfig').clangd.setup({
  cmd = {
    "clangd",
    "--query-driver=/usr/bin/g++", -- 替换为你实际使用的g++路径
    "--background-index",
    "--clang-tidy",
    "--header-insertion=iwyu",
  },
  -- 其他原有配置保持不变
})

这个参数会让clangd和你执行bear -- g++ main.cpp时的头文件查找路径完全一致。

3. 验证compile_commands.json与头文件路径 #

可以手动检查clangd对配置文件的解析情况，在项目根目录运行：

clangd --check=./main.cpp

如果输出明确提示找不到<iostream>，可以用g++查看实际使用的头文件路径：

g++ -v main.cpp 2>&1 | grep -A 10 "include paths"

然后在clangd配置中添加--system-include-path参数，将g++输出的路径逐一加入：

cmd = {
  "clangd",
  "--query-driver=/usr/bin/g++",
  "--system-include-path=/usr/include/c++/11",
  "--system-include-path=/usr/include/x86_64-linux-gnu/c++/11",
  -- 其他参数
}

4. 更新clangd版本 #

若你的clangd版本过老，可能与当前g++的标准库版本不兼容，建议更新到最新稳定版：

sudo apt install clangd-17
sudo update-alternatives --install /usr/bin/clangd clangd /usr/bin/clangd-17 100

设置默认版本后重启nvim即可测试。

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