clangd编译正常却报头文件找不到？directory设为.的问题解析

我有一个compile_commands.json，每个源文件的配置条目如下：

[
  {
    "directory": ".",
    "command": "clang++ -I/usr/local/include -I/usr/local/opt/libomp/include -std=c++2a -MT release/source.o -MMD -MP -MF release/source.d Wall -O3 -fopenmp -flto -DNDEBUG -c -o release/source.o source.cpp",
    "file": "source.cpp"
  },
  ...
]

使用该配置编译项目可成功，但clangd语言服务器在VS Code中报告无法找到实际位于/usr/local/include下的头文件。运行clangd --check的输出显示，内部cc1参数未包含我指定的命令行选项。

注：clang++和clangd均为Homebrew安装的15.0.7版本，路径为/usr/local/opt/llvm/bin/clang++，使用compile_flags.txt可正常工作。

后续发现问题根源是"directory": "."，将其改为明确的工作目录后恢复正常，请问这是为什么？

原因解析 #

• directory字段的核心作用是指定clangd执行编译命令时的工作目录，所有编译参数里的路径、源文件路径都会基于这个目录做解析。
• 当设置"directory": "."时，这个相对路径的解析完全依赖clangd启动时的工作目录，而非你项目的实际根目录。VS Code中clangd的启动目录可能和你手动执行编译命令的目录不一致——比如你在项目根目录运行编译工具生成compile_commands.json，但VS Code可能从其他路径启动clangd，导致.指向的不是项目根目录，进而让-I这类路径参数解析出错，甚至被clangd判定为无效而忽略。
• 换成明确的绝对路径（比如/Users/xxx/your-project-root）后，clangd能精准确定执行命令的工作目录，所有编译参数都会基于这个正确路径解析，自然就能识别到/usr/local/include下的头文件以及其他依赖路径。
• 而compile_flags.txt能正常工作，是因为它默认以自身所在的目录作为工作目录，不需要额外指定，因此不会出现路径解析错位的问题。

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