必须禁用c/c++插件的intellisense引擎，否则与clangd冲突导致补全卡顿、跳转错乱；clangd依赖compile_commands.json获取真实编译信息，缺失则报头文件未找到或符号未定义；--query-driver须指向项目实际使用的编译器。
直接禁用 C/C++ 插件的 IntelliSense 引擎，改用 clangd —— 这不是权宜之计，而是当前（2026年）大型 C++ 项目下最稳定、响应最快的选择。微软官方插件在 v1.15+ 后对大型项目索引逻辑未做本质优化，更新后反而更容易触发 file name cache 填充阻塞，导致跳转定义延迟超 3 秒甚至无响应。
为什么更新后更卡：IntelliSense 的缓存机制缺陷
VS Code 更新常会同步升级 vscode-cpptools，新版默认启用更激进的文件名缓存预加载（见 Issue #12169）。它会在打开工作区时扫描所有 **/*.h 和 **/*.cpp 文件路径，不区分是否实际参与编译。OpenHarmony、STM32 HAL 或 50 万行以上的跨平台项目中，这个过程极易卡死主线程。
- 现象：光标闪烁 2–5 秒无补全，
Go to Definition转圈超过 10 秒，状态栏长期显示 “Parsing files…” - 根本原因：
C_Cpp.intelliSenseEngine仍为Default或Tag Parser，未切断索引源头 - 验证方式：运行命令
Developer: Show Running Extensions，观察ms-vscode.cpptools的“启动耗时”是否 >800ms
必须立即执行的三项配置
仅安装 clangd 扩展不够，关键在隔离旧服务、指定数据源、关闭冗余监听。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 在
settings.json中强制禁用 IntelliSense："C_Cpp.intelliSenseEngine": "disabled" - 确保 clangd 使用项目级
compile_commands.json，而非尝试自己推导："clangd.arguments": ["--compile-commands-dir=build"]（路径需与你 CMake 构建目录一致） - 排除干扰性文件监视：
"files.watcherExclude": { "**/build/**": true, "**/out/**": true, "**/target/**": true }
clangd 启动失败或不生效的常见原因
clangd 不报错但没补全？大概率是路径或权限问题，而非功能异常。
-
clangd.path指向错误：Windows 上若用 MSVC 工具链，不要用clang.exe路径，而要用clangd.exe（LLVM 官方包自带）；macOS 用brew install llvm后路径是/opt/homebrew/opt/llvm/bin/clangd - 找不到
compile_commands.json：clangd 默认只在工作区根目录找，如果它在build/下，必须显式用--compile-commands-dir参数，不能靠clangd.fallbackFlags补救 - 权限拒绝（Linux/macOS）：检查
build/compile_commands.json是否可读，尤其当 CMake 由 root 运行生成时，普通用户 VS Code 可能无权读取
真正棘手的不是配置本身，而是 clangd 对 compile_commands.json 的依赖是刚性的 —— 它不会退化到“尽力而为”，而是直接沉默。一旦构建目录变动、CMake 重生成失败、或 JSON 文件格式损坏（比如末尾少逗号），clangd 就停止提供任何语义功能，且控制台日志里可能只有一行 Failed to load compilation database。务必在切换前确认该文件存在、可读、结构合法。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
