Clangd补全不生效主因是未获取正确编译参数，需确保compile_commands.json生成并被正确识别：在CMakeLists.txt加set(CMAKE_EXPORT_COMPILE_COMMANDS ON)或cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=1 ..生成该文件，置于根目录或通过clangd.arguments指定路径；禁用VSCode中Microsoft C/C++插件避免冲突；Windows下遇-imsvc错误需在.clangd中添加-Xclang -imsvc；修改配置后必须重启Clangd语言服务器。
Clangd 补全不生效，90% 的情况不是插件没装好，而是它根本没拿到正确的编译参数——compile_commands.json 没生成、路径不对、或内容被 Clangd 忽略了。
Clangd 启动后报 pp_file_not_found 或补全空白
这是典型「找不到头文件」症状，本质是 Clangd 没读到你项目里真实的包含路径。CMake 默认不生成 compile_commands.json，必须显式开启：
-
cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=1 ..（推荐在build/目录下执行） - 或在
CMakeLists.txt顶部加：set(CMAKE_EXPORT_COMPILE_COMMANDS ON) - 生成的
compile_commands.json必须放在项目根目录，或通过"clangd.arguments": ["--compile-commands-dir=build"]显式指向其所在路径 - 注意：Clangd v10 及更早版本要求该文件必须在根目录；v12+ 支持指定子目录，但路径必须存在且可读
VSCode 中 clangd 和 C/C++ 插件冲突导致补全失效
Microsoft 的 C/C++ 扩展会劫持语言服务器通道，即使你只用它来调试，也会压制 Clangd 的语义分析能力：
- 必须禁用整个扩展：在扩展面板中对
C/C++ by Microsoft点击齿轮 → Disable Workspace（仅禁用当前工作区即可） - 不要只关
"C_Cpp.intelliSenseEngine": "disabled"，这个配置已过时，且无法阻止后台索引干扰 - 重启 VSCode 后，状态栏左下角应显示
clangd而非C/C++，右下角无红色报错提示
Windows 下 Xmake 或 MSVC 工具链引发 -imsvc 参数错误
错误信息如 error: unknown argument: '-imsvc'，说明 Clangd 遇到 MSVC 风格的包含路径参数，但未启用兼容模式：
- 在项目根目录新建
.clangd文件，内容为：
CompileFlags: Add: [-Xclang, -imsvc] Remove: [-Wno-microsoft-enum-value, -Wno-microsoft-include]
-
-Xclang -imsvc是关键：它把-imsvc原样透传给 Clang 前端，绕过 Clangd 自身参数校验 - 若项目用 Qt Creator 生成
compile_commands.json，还需额外加Add: ["-x", "c++"]强制按 C++ 解析，否则 .h 文件可能被当 C 处理
ROS 或复杂多 workspace 项目头文件仍找不到
即使有 compile_commands.json，Clangd 也只认其中记录的路径；ROS 的系统级头文件（如 /opt/ros/noetic/include）往往不在该文件里：
- 用
bear -- catkin_make替代原命令，在 ROS workspace 根目录执行，能捕获所有子包的编译参数并写入compile_commands.json - 若仍有遗漏，手动在
.clangd中补充Add:列表，例如：-I/opt/ros/noetic/include、-I/usr/include/pcl-1.12 - 每改一次
.clangd，必须执行Ctrl+Shift+P→Restart Clangd Language Server，否则配置不生效
最容易被忽略的是：Clangd 不会自动 reload .clangd 或 compile_commands.json 的变更，改完不重启服务，等于没改。
