启用Clangd等工具需先生成compile_commands.json：CMake项目应在构建目录运行cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON；非CMake项目可用bear拦截编译命令；文件须为合法json、Directory为绝对路径且Clangd按父目录逐级查找。
直接生成 compile_commands.json 是启用 Clangd、Clang-Tidy 等工具的前提，但多数 c++ 项目默认不生成它——必须通过构建系统显式开启。
用 CMake 生成 compile_commands.json 的正确方式
CMake 是目前最主流的支持途径，关键不是“能不能”，而是“怎么开才真正生效”。很多用户执行了 cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON 却发现文件没出现，往往是因为没在构建目录里运行，或用了 Ninja/Make 混淆了路径。
- 必须在 构建目录（build dir） 中运行 CMake 配置命令，而不是源码根目录
-
cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -G "Ninja" ..或cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON ..（后者依赖默认 generator） - 生成后，
compile_commands.json会出现在构建目录顶层，不是源码目录 - 如果用 vs code + CMake Tools 插件，需确保其“构建目录”设置与你手动配置的一致，否则插件可能读不到该文件
非 CMake 项目：手动构造或用 bear 拦截编译命令
对于 Makefile、autotools 或手写 build.sh 的项目，CMake 参数无效。此时不能靠改配置，得靠“捕获”真实编译过程。
-
bear是最轻量可靠的方案：先装bear（如apt install bear或brew install bear），再用它包裹构建命令：bear -- make或bear -- cmake --build . - 注意：
bear依赖gcc/clang的 wrapper 行为，若项目用g++-12或自定义编译器路径，需提前设好CC/CXX环境变量 - 手动写
compile_commands.json极易出错（比如directory字段路径不对、arguments缺少-I或宏定义），不推荐
Clangd 读不到 compile_commands.json 的常见原因
即使文件存在，Clangd 仍可能 fallback 到简易解析，导致跳转不准、宏不展开、头文件找不到——这不是 Clangd 问题，而是路径或内容不匹配。
立即学习“C++免费学习笔记（深入）”；
- Clangd 默认只在当前打开文件的**父目录向上逐级查找**
compile_commands.json，不会自动扫描子目录或符号链接外的路径 -
directory字段必须是绝对路径，且指向实际执行编译命令的工作目录（否则-I relative/path会解析失败） - 如果项目含子模块（submodule）或外部依赖（如
third_party/），确保这些路径在arguments中以-I或-isystem正确声明，Clangd 不会自动推断 - VS Code 中，确认
"clangd.arguments"设置没覆盖掉自动检测，例如删掉--compile-commands-dir=...这类硬编码路径
[ { "directory": "/home/user/project/build", "command": "/usr/bin/clang++ -I../include -DDEBUG -std=c++20 -c ../src/main.cpp", "file": "../src/main.cpp" } ]路径不一致、字段名拼错（比如写成 cmd 而非 command）、JSON 格式非法（末尾多逗号、中文引号），都会让整个文件被忽略——Clangd 不报错，只静默降级。