clangd 比微软 c++ 插件快在直接复用 clang 编译器前端做语义分析，跳过抽象层和 intellisense 数据库，依赖正确的 compile_commands.json 实现秒级跳转补全，但不支持非标准宏补丁和类型猜测。
Clangd 比微软 C++ 插件快在哪？
Clangd 是基于 Clang 的语言服务器，直接复用编译器前端做语义分析，跳过了微软插件里那层抽象和索引中间层。它不依赖 IntelliSense 数据库（ipch 或 .vsidb），也不在后台反复解析头文件树——只要 compile_commands.json 正确，打开文件几乎立刻就能跳转、补全。
但这也意味着：它不会“猜”你没写完的类型，也不会给非标准宏（比如 MSVC 特有宏）打补丁。快的前提是项目配置干净。
- 微软插件在大型模板项目里容易卡在“Updating IntelliSense...”，Clangd 不会显示这行字，但若
compile_commands.json缺失或路径错，它直接不工作 - Clangd 对 C++20 概念、模块（
import）支持更及时；微软插件目前仍限制较多 - Clangd 默认不处理 Windows SDK 头路径（除非你显式配置
--query-driver），而微软插件开箱即用
怎么生成靠谱的 compile_commands.json
这是 Clangd 能不能工作的生死线。不是“有没有”，而是“路径对不对”“编译选项全不全”。CMake 项目最稳，但必须加 -DCMAKE_EXPORT_COMPILE_COMMANDS=ON，且不能只跑 cmake . ——要进 build 目录再生成：
mkdir build && cd build cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON ..
生成后检查 compile_commands.json 里每条记录的 directory 字段是否为绝对路径，command 是否包含完整 include（尤其是 -I 和 -isystem）。常见翻车点：
- 用 Ninja 生成但没装
ninja，CMake 回退到 Makefile，结果compile_commands.json里命令是make而非clang++，Clangd 解析失败 - VSCode 在非 build 目录打开工作区，Clangd 找不到
compile_commands.json—— 它只认根目录或.vscode/c_cpp_properties.json里指定的路径 - 用
clang++ -x c++编译但compile_commands.json写成g++，Clangd 会忽略该条目（默认只信任 clang 系驱动）
VSCode 里怎么配 Clangd 才不白装
光装 llvm-vs-code-extensions.vscode-clangd 插件不够，关键在 .vscode/settings.json 里告诉它去哪儿找东西。最简有效配置：
{
"clangd.path": "/usr/bin/clangd", // Linux/macOS；Windows 用类似 "C:\LLVM\bin\clangd.exe"
"clangd.arguments": [
"--compile-commands-dir=build",
"--background-index",
"--header-insertion=iwyu",
"--query-driver=/usr/bin/clang++"
]
}
--query-driver 是 Windows 和混合工具链项目的救命项：它让 Clangd 去读 clang++ 的内置 include 路径，否则连 <vector></vector> 都标红。其他要点：
-
--background-index开启后，Clangd 会在空闲时索引整个项目，但首次打开大项目仍会卡几秒 —— 这不是 bug，是它在建符号图 - 如果项目含子模块或第三方库（如
third_party/abseil），得加--cross-file-references，否则跨目录跳转会失败 - 禁用微软 C++ 插件：在扩展面板里右键 “C/C++” → “Disable (Workspace)”，否则两个 LSP 抢着发诊断，补全候选乱序
Clangd 报 “no compile commands” 或 “failing to load translation unit” 怎么查
这不是插件坏了，是 Clangd 明确拒绝加载当前文件。先看 VSCode 右下角状态栏有没有 clangd: idle 或 clangd: indexing —— 如果一直显示 clangd: initializing...，说明它卡在找 compile_commands.json。
打开命令面板（Ctrl+Shift+P），运行 Clangd: Restart language server，然后立即看输出面板（Output → Clangd）里的第一行错误。90% 是下面三种：
-
Failed to find compilation database for /path/to/file.cpp→ 检查compile_commands.json是否存在、路径是否被--compile-commands-dir覆盖 -
Could not resolve path '/some/relative/include.h' in command→compile_commands.json里directory是相对路径，Clangd 不认，必须绝对路径 -
error: unknown argument: '-march=armv8-a'→--query-driver指定的 clang++ 版本太低，不支持该 flag，换匹配的 LLVM 版本或删掉该编译选项
Clangd 的日志很直白，但它不会告诉你“你少装了什么”，只会说“我读到了什么、哪里断了”。盯住输出面板第一行，比 Google 报错信息管用十倍。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
