c++oding="utf-8" ?>
cmake找不到头文件需启用cmake_export_compile_commands生成compile_commands.json，配置clangd指向build目录，改用target_include_directories()替代include_directories()，清理build后重建并重启vscode。
找不到头文件：检查 #include 路径和实际文件位置是否匹配
Clang 报 No such file or directory，90% 是头文件路径没对上。不是编译器坏了，而是它真没找到你写的那个 #include "xxx.h" 或 #include <yyy></yyy>。
常见错误现象：#include "utils.h" 报错，但你在当前目录下明明有这个文件；或者 #include <boost></boost> 失败，却忘了装 boost 或没告诉 Clang 去哪找。
- 相对路径（
"xxx.h"）从 包含该#include的源文件所在目录 开始查找，不是从命令行执行目录 - 系统路径（
<xxx></xxx>）只查 Clang 默认路径（如/usr/include）和用-I显式添加的路径 - 用
clang++ -v main.cpp可看到 Clang 实际搜索的所有 include 路径（注意输出里以#include "..." search starts here:和#include <...> search starts here:</...>开头的部分）
-I 参数加对了吗：路径别漏掉、别写错、别用 Windows 反斜杠
-I 是告诉 Clang “去这个目录里找头文件”，但它很老实，只认你给的路径，多一个空格、少一个 /、用了 都会失败。
使用场景：项目结构是 src/main.cpp 包含 "../include/common.h"，但 Clang 默认不往上翻目录，就得加 -I../include。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 路径必须是 相对于命令行执行位置，不是相对于源文件 —— 这点最容易搞混
- 多个路径用多个
-I，不要写成-Ipath1:path2（那是 GCC 的-isystem旧写法，Clang 不认） - Mac 上 Homebrew 安装的库（比如
yaml-cpp），头文件通常在/opt/homebrew/include，得手动加-I/opt/homebrew/include - Windows 下用 Clang（如通过 MSVC 工具链），路径分隔符必须是
/或\，不能单用（会被当转义符处理）
系统头文件缺失：不是所有 <xxx></xxx> 都自带，有些得装开发包
Clang 自带标准库头文件（如 <vector></vector>、<string></string>），但像 <curl></curl>、<png.h></png.h> 这类第三方头文件，它不会自动下载 —— 它只负责编译，不管安装。
错误现象：fatal error: 'curl/curl.h' file not found，但 curl --version 能正常运行 —— 说明只装了 runtime，没装 dev 包。
- Ubuntu/Debian：装
libcurl4-openssl-dev（不是curl包） - CentOS/RHEL：装
libcurl-devel - macOS + Homebrew：装
libcurl（Homebrew 的libcurl包默认含头文件） - 确认头文件是否存在：
find /usr -name "curl.h" 2>/dev/null，如果找到了，再用-I指向其父目录（比如/usr/include/x86_64-linux-gnu）
C++ 标准库头文件报错：检查是否漏了 --stdlib= 或链接了错误的 stdlib
某些环境下（尤其是 macOS 或自定义 toolchain），Clang 找得到 <string></string> 却报 No such file or directory，其实是它默认用的 libc++ 头文件路径不对，或你强制用了 libstdc++ 但没配好。
典型触发条件：用 clang++ -stdlib=libstdc++ 编译，但系统没装 GNU libstdc++ 的头文件（常见于 macOS，默认只有 libc++）。
- macOS 上建议直接用默认（libc++），不要加
--stdlib=libstdc++ - Linux 上若要用 libc++，需额外安装
libc++-dev（Ubuntu）或libcxx-devel（RHEL），并加-I/usr/include/c++/v1和-lc++ - 用
clang++ -E -x c++ /dev/null -dM | grep STDLIB可看预定义宏，判断当前默认 stdlib 类型
最麻烦的情况是交叉编译或用非系统 toolchain，这时候 -isysroot 和 --sysroot 得配合 -I 一起调，否则头文件和库路径会错位 —— 这种问题往往要一行行比对 clang++ -v 输出里的搜索路径才定位得准。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
