必须加该参数，因为cmake默认不生成compile_commands.json；只有启用cmake_export_compile_commands=on后，构建系统才会将每个.cpp文件的实际编译命令（含-i、-d、-std等）写入该文件，供clangd、clang-tidy和vscode精准还原编译上下文，否则将出现头文件找不到、宏未定义、跳转错误等问题。
cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON 为什么必须加这个参数
不加它，CMake 就不会把每个 .cpp 文件实际用什么命令、带什么 -I、-D、-std= 编译，写进 compile_commands.json。Clangd、clang-tidy、vscode 跳转全靠这个文件还原编译上下文，没它就只能瞎猜——结果就是头文件找不到、宏未定义、跳转到错误位置。
常见错误现象：
-
clangd启动后日志里反复出现Failed to load compilation database - Ctrl+Click 函数名提示
No definition found -
clang-tidy报一堆use of undeclared identifier，明明代码能编译过
实操建议：
- 必须在
cmake配置阶段加，不是构建阶段：mkdir build && cd build && cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON .. -
ON和1都可以，但别写成True（某些旧版 CMake 会忽略） - 生成位置固定在 build 目录下，不是项目根目录；VS Code 默认只认根目录的
compile_commands.json，所以得补一句：ln -s build/compile_commands.json .
bear -- make 为什么有时不生成 compile_commands.json
Bear 不是解析 Makefile，而是靠 LD_PRELOAD 劫持子进程调用的 gcc、g++、clang++。如果构建过程根本没调用这些编译器，它就捕不到任何命令。
典型场景：
-
make返回make: Nothing to be done—— clean 没做，缓存导致没真正编译 - 用了 Ninja（
cmake -G Ninja），Bear 对 Ninja 的拦截不稳定，尤其在 macOS 上常失效 - 编译器被 wrapper 封装（比如
ccache g++或自定义脚本），Bear 默认只 hookg++，不识别 wrapper 名
实操建议：
- 先
make clean，再bear -- make -j；clean 本身不用加bear -- - CMake 项目想用 Bear，显式指定生成器：
cmake -G "Unix Makefiles" ..，避免 Ninja - 若 wrapper 不可绕过，用
--append+ 手动补command字段，或改用 CMake 原生方案
compile_commands.json 里 directory 和 command 字段到底影响什么
这两个字段决定 Clangd 能不能正确找到头文件、展开宏、识别标准版本。它们不是装饰，是运行时真实环境的快照。
directory 是工作目录，影响所有相对路径（比如 -I../include）；command 是完整 shell 命令字符串，Clangd 会按字面解析，包括空格、引号、转义。
容易踩的坑：
-
directory写错（比如多了一层build/），会导致-I./include变成build/./include，头文件全挂 -
command里含 shell 变量（如$PWD）或管道（|）、重定向（>）——JSON 不支持，Clangd 直接解析失败 - Windows 上路径分隔符混用（
\vs/），某些版本 clangd 会卡在路径拼接
验证方法：打开 compile_commands.json，找一个你熟悉的 .cpp 条目，复制 command 字符串，在 directory 指向的路径下粘贴执行，看是否真能编译通过。
ROS 2 / colcon 项目怎么让 clangd 识别 /opt/ros/humble/include
colcon 本身不自动导出 compile_commands.json，即使你装了 python3-colcon-json，也得配合 CMake 参数才生效。否则 clangd 根本不知道 ROS 头文件在哪。
关键点：
-
colcon build --cmake-args -DCMAKE_EXPORT_COMPILE_COMMANDS=ON必须加，且要放在--cmake-args后面，不是全局参数 - 生成的
compile_commands.json在build/<package_name>/</package_name>下，不是统一在 workspace/build/；得用find build -name compile_commands.json | head -n1定位，再软链到 workspace 根目录 - 如果仍有头文件报错，检查
command字段里是否含-isystem /opt/ros/humble/include；没有的话，说明 CMakeLists.txt 里漏了ament_target_dependencies或find_package
不要靠 .clangd 硬加 -I/opt/ros/...：ROS 包之间有依赖传递和接口头文件导出机制，手动加路径会绕过这一层，导致跨包跳转失效。
