如何让clangd使用自定义LLVM安装而非系统头文件？

1. 生成并使用编译数据库（compile_commands.json） #

clangd 核心依赖编译数据库获取编译参数，这是最可靠的头文件路径指定方式：

• 若用CMake构建项目，添加以下参数生成包含自定义路径的编译数据库：

  cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -DCMAKE_CXX_COMPILER=/path/to/my/llvm/bin/clang++ ..
  

  生成的compile_commands.json会自动携带自定义LLVM的头文件路径与编译选项。
• 手动维护编译数据库的话，在每个编译条目里添加-I/path/to/my/llvm/include参数，示例：

  [
    {
      "directory": "/path/to/your/project",
      "command": "/path/to/my/llvm/bin/clang++ -I/path/to/my/llvm/include -c main.cpp -o main.o",
      "file": "main.cpp"
    }
  ]
  

  将该文件放在项目根目录，clangd启动时会自动读取。

2. 配置clangd启动参数 #

直接给clangd指定头文件优先级：

• 编辑器（如VS Code）中，在settings.json添加如下配置：

  "clangd.arguments": [
    "-I/path/to/my/llvm/include",
    "--system-header-prefix=/path/to/my/llvm/include"
  ]
  

  --system-header-prefix会让该路径下的头文件被当作系统头文件处理，优先级高于默认系统路径。
• 终端直接运行clangd时，执行命令：

  /path/to/my/llvm/bin/clangd -I/path/to/my/llvm/include --system-header-prefix=/path/to/my/llvm/include
  

3. 使用.clangd配置文件 #

在项目根目录或用户主目录创建.clangd文件，写入以下内容：

CompileFlags:
  Add: [-I/path/to/my/llvm/include]
  Remove: [-I/usr/include, -I/usr/local/include] # 可选，移除默认系统头文件路径

该配置会覆盖clangd的默认编译参数，强制优先使用自定义LLVM的头文件路径。

4. 修复环境变量设置 #

CPLUS_INCLUDE_PATH不生效通常是以下原因：

• 环境变量未正确加载：执行export命令后，需在同一终端启动编辑器；或把export CPLUS_INCLUDE_PATH=/path/to/my/llvm/include添加到~/.bashrc/~/.zshrc，再执行source ~/.bashrc生效。
• 路径错误：确认/path/to/my/llvm/include下存在完整的LLVM头文件（比如llvm/IR/Module.h这类核心文件）。

5. 确认使用的是自定义LLVM的clangd #

先检查当前clangd的路径：

which clangd

若输出不是/path/to/my/llvm/bin/clangd，说明调用的是系统自带版本，需将自定义LLVM的bin目录加到PATH最前面：

export PATH=/path/to/my/llvm/bin:$PATH

用echo $PATH验证自定义路径是否排在系统路径之前。

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