应禁用微软C/C++插件以避免冲突，通过设置"C_Cpp.intelliSenseEngine": "disabled"并重启VSCode或重启Clangd服务；clangd依赖compile_commands.json解析编译信息，可通过CMake或bear生成；推荐使用项目级.clangd文件精细配置；Windows需手动指定clangd路径并检查输出面板日志。
clangd 和 C/C++ 插件不能共存
直接禁用微软的 C/C++ 插件，否则会出现重复补全、跳转失效、诊断冲突等问题。VSCode 启动 clangd 时会主动弹窗提示，点 Disable IntelliSense 即可。也可以手动在 settings.json 中加一行："C_Cpp.intelliSenseEngine": "disabled"。改完后必须重启 VSCode 或执行命令 Restart Clangd Language Server（Ctrl+Shift+P 输入），否则配置不生效。
compile_commands.json 是 clangd 的“眼睛”
clangd 不靠猜，它依赖 compile_commands.json 知道每个源文件怎么编译、包含哪些头路径、用什么标准。没这个文件，补全基本靠运气。
- 用 CMake 项目：在构建前加
-DCMAKE_EXPORT_COMPILE_COMMANDS=ON，例如：cmake -B build -DCMAKE_EXPORT_COMPILE_COMMANDS=ON - 用 Make 或 catkin：装
bear，然后bear make或bear catkin_make，生成文件默认放在当前目录 - 验证是否生效：打开一个
.cpp文件，右下角状态栏应显示clangd: ready；按 Ctrl+Click 能跳转到标准库或自定义头文件里
.clangd 文件比 settings.json 更灵活
settings.json 只能全局设 clangd.arguments，而 .clangd（YAML 格式，放项目根目录）能按路径、文件类型精准控制行为，比如只对 .h 文件启用模板推导提示。
Clang 22.1.3 Windows 64 位历史版本安装包，适合旧项目兼容、LLVM/Clang 工具链回退、编译行为对比、链接问题复现和 C/C++ 构建环境维护。
常见误配点：
-
Add里写绝对路径（如-I/usr/include/eigen3）没问题，但相对路径（如-Iinclude）是相对于.clangd所在位置，不是源文件位置 -
Remove: ["-Werror"]必须写全匹配项，-Werror=return-type不会被-Werror移除 - 如果项目有多个子模块且头路径分散，别只靠
compile_commands.json，必须用.clangd的CompileFlags.Add补齐
Windows 上 clangd 路径容易出错
VSCode 自动安装的 clangd 默认放在用户目录下（如 %USERPROFILE%.vscodeextensionsllvm-vs-code-extensions.vscode-clangd-*），但有时会找不到或版本太旧。更稳的方式是手动装 LLVM 并指定路径：
- 从 LLVM 官方 release 页面 下载 Windows 版 installer（带 clangd）
- 安装后，在
settings.json中显式指定："clangd.path": "C:\Program Files\LLVM\bin\clangd.exe" - 注意路径中的反斜杠要双写，单个
会被解析为退格符
真正麻烦的不是装不上，而是 clangd 启动后静默失败——它不报错，但补全和跳转全挂。遇到这种情况，先看输出面板切换到 Clangd 标签，里面通常有 Failed to load compilation database 或 resource directory not found 这类关键线索，而不是盯着编辑器界面干猜。
