clangd读取compile_commands.json的关键在于directory字段必须为绝对路径且匹配真实编译工作目录，lsp默认向上逐级查找该文件，硬编码--compile-commands-dir会覆盖自动查找逻辑，非cmake项目需用bear并正确设置cc/cxx环境变量。
cmake生成的compile_commands.json必须放在构建目录顶层
Clangd等LSP服务器默认只在当前打开文件的父目录向上逐级查找compile_commands.json，不会扫描子目录或符号链接外的路径。如果你在源码根目录运行cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON，文件不会生成——必须先mkdir build && cd build，再执行cmake .. -DCMAKE_EXPORT_COMPILE_COMMANDS=ON。生成后，compile_commands.json一定出现在build/目录下，不是src/或项目根目录。
directory字段必须是绝对路径且指向真实编译工作目录
这个字段决定所有相对-I路径（比如-I../include）能否被正确解析。如果它写成相对路径、空值或指向不存在的目录，Clangd会fallback到简易解析，导致头文件找不到、宏不展开、跳转失效。
-
directory字段值必须是绝对路径，例如/home/user/myproj/build - 该路径必须与实际执行
g++命令时的cwd一致（即你运行make或ninja时所在的目录） - 如果项目含
third_party/或子模块，确保arguments里用-I或-isystem显式声明，Clangd不会自动推断
VS Code / Sublime / neovim中不能硬编码--compile-commands-dir
很多用户在clangd.arguments里加--compile-commands-dir=./build，结果LSP仍读不到——因为Clangd优先按“当前文件→父目录→逐级向上”搜索compile_commands.json，硬编码参数反而会覆盖自动查找逻辑，尤其当文件不在预期目录结构中时。
- VS Code：删掉
c_cpp_properties.json中"compileCommands"字段的硬路径，让C/C++插件自动发现 - Sublime LSP：在
LSP-clangd.sublime-settings中不要设compilationDatabasePath，除非你明确需要非标准位置 - neovim + clangd：避免在
init.lua中用cmd = { "clangd", "--compile-commands-dir=build" }，改用cmd = { "clangd" }并确保工作目录正确
非CMake项目用bear生成时环境变量必须对齐
如果你的项目用make或自定义build.sh，bear -- make看似简单，但极易失败——bear依赖gcc/clang wrapper机制拦截调用，若项目实际用g++-12或交叉编译器，必须提前设置CC/CXX：
-
export CC=gcc-12 CXX=g++-12，再运行bear -- make -j - 如果构建过程涉及
pkg-config或find_package()，bear无法捕获这些间接路径，生成的arguments可能缺-I或-D - Windows上用MSVC时，
bear完全不可用；此时必须切到Ninjagenerator：cmake -G Ninja -DCMAKE_EXPORT_COMPILE_COMMANDS=ON ..
Clangd能不能读到compile_commands.json，从来不是文件存不存在的问题，而是它的directory对不对、路径层级是否匹配、以及LSP客户端有没有用错查找逻辑——这三个点任何一个出错，都会让你看到“跳转失败”却查不出原因。
