必须禁用C/C++插件的IntelliSense引擎，否则与clangd冲突导致补全卡顿、跳转错乱；clangd依赖compile_commands.json获取真实编译信息，缺失则报头文件未找到或符号未定义；--query-driver须指向项目实际使用的编译器（如arm-none-eabi-gcc），且需在config.yaml中补充系统头路径。
Clangd 能明显改善 C++ 项目（尤其是嵌入式、大型或 CMake 构建的项目）的智能提示延迟、跳转失效和头文件报错问题，但配置失败往往不是因为步骤错了，而是几个关键点没对齐：插件冲突、compile_commands.json 缺失、--query-driver 指向错误编译器，或者 C_Cpp.intelliSenseEngine 没真正禁用。
必须禁用 C/C++ 插件的 IntelliSense 引擎
微软的 C/C++ 插件（ms-vscode.cpptools）和 clangd 不能共存为语言服务器——它们会抢着解析同一份代码，结果是补全卡顿、定义跳转乱跳、甚至编辑器 CPU 占用飙升。这不是“可以共存，只是推荐禁用”，而是“不关就必然出问题”。
- 打开 VSCode 设置（
Ctrl+,），搜索IntelliSense Engine，把C_Cpp.intelliSenseEngine设为Disabled - 不要只停用插件 UI，要进
settings.json确认该字段存在且值为"Disabled"；有些用户在 GUI 里点了禁用，但配置没写入 JSON，重启后自动恢复 - 如果你不需要 C/C++ 插件的调试功能（GDB/LLDB 集成），建议直接禁用整个插件；需要的话，保留它，但确保只让它管调试，不管代码分析
clangd 必须能读到 compile_commands.json
Clangd 的精准性核心在于它复用真实编译环境——而这个信息全靠 compile_commands.json 提供。没有它，Clangd 只能靠猜：默认标准、默认头路径、忽略宏定义，于是满屏 undefined symbol 或 file not found。
- CMake 项目：在
cmake命令里加-DCMAKE_EXPORT_COMPILE_COMMANDS=1，例如：cmake -B build -DCMAKE_EXPORT_COMPILE_COMMANDS=1；生成的compile_commands.json默认在build/目录下 - 非 CMake 项目（如 Keil/Makefile）：需手动构造
compile_commands.json，或用工具如compiledb从Makefile日志提取；单纯靠--query-driver是补不全的 - 在
settings.json中显式指定位置，避免 Clangd 找错地方："clangd.arguments": ["--compile-commands-dir=build"]（路径相对于工作区根目录）
--query-driver 参数必须指向你实际用的编译器
这个参数不是可选项，尤其在嵌入式场景下。Clangd 用它来“借”编译器的系统头路径、内置宏、目标架构等信息。如果填了 /usr/bin/g++ 但你工程实际用的是 arm-none-eabi-gcc，那所有 ARM 特有头文件（比如 core_cm4.h）都会标红。
立即学习“C++免费学习笔记（深入）”；
- Linux/macOS：确认编译器路径存在，运行
which arm-none-eabi-gcc或which clang++，把输出结果完整填进--query-driver - Windows：路径要用正斜杠或双反斜杠，例如
"--query-driver=C:/Program Files/ARM/GNU Arm Embedded Toolchain/10.3 2021.10/bin/arm-none-eabi-gcc.exe" - 多个编译器？Clangd 不支持逗号分隔，只能填一个最常用的；若项目混用，优先填主控芯片编译器（如 STM32 用
arm-none-eabi-gcc，IMX6ULL 用arm-linux-gnueabihf-gcc）
头文件找不到？先检查 config.yaml 而不是 settings.json
VSCode 的 settings.json 控制的是插件行为，但 Clangd 自身的全局配置（比如强制包含路径、fallback 标准）存在独立的 config.yaml 文件里。国内用户常遇到 “明明设置了 --query-driver 还是找不到 stdint.h”，就是因为它压根没读到编译器提供的 sysroot。
- Windows 路径通常为：
C:\Users\{用户名}\AppData\Local\clangd\config.yaml - Linux/macOS 路径通常为：
~/.config/clangd/config.yaml - 在里面加一段（注意缩进）：
CompileFlags: Add: [-I/usr/lib/gcc/arm-none-eabi/10.3.1/include]
路径来源：运行 arm-none-eabi-gcc -v -E -x c /dev/null 2>&1 | grep "#include"，取其中 search starts here: 后面的路径。
Clangd 对嵌入式项目的兼容性不差，差的是配置没落到它真正读取的地方——config.yaml 比 settings.json 更底层，也更容易被忽略。
