答案是Clang未正确指向macOS SDK路径所致。从Mojave起系统头文件移入SDK，需通过-isysroot $(xcrun --show-sdk-path)显式指定；先运行xcode-select --install和sudo xcode-select --reset确保工具链就绪，再验证xcrun --show-sdk-path输出有效路径。
clang++ 编译时报 “fatal error: 'iostream' file not found”
这不是代码问题，而是 Clang 没法定位 macOS SDK 中的系统头文件。从 Mojave 开始，/usr/include 被移除，所有标准头文件（包括 iostream、stdio.h）都打包进 Xcode SDK 里，Clang 必须通过 -isysroot 显式指定路径才能访问。
- 先运行
xcode-select --install安装命令行工具（哪怕已装 Xcode，这步也不能跳） - 再执行
sudo xcode-select --reset，否则 VSCode 可能读不到正确路径 - 验证：运行
clang++ --version和xcrun --show-sdk-path，后者应输出类似/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk的路径 - 如果用了 Homebrew 安装的
llvm（比如需要 OpenMP），它默认不带 SDK 路径，必须加参数：clang++ -isysroot $(xcrun --show-sdk-path) main.cpp
VSCode 编辑器里 clangd 报找不到第三方库（如 OpenCV、Boost）
clangd 不会自己猜路径，它只认 compile_commands.json —— 这个文件由 CMake 生成，里面精确记录了每个源文件编译时用的 -I 头文件路径和 -D 宏定义。
- 确保你在项目根目录下建了
build/目录，并在其中运行：cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON .. - 生成的
compile_commands.json必须放在项目根目录（或通过 VSCode 设置"compileCommands"指向它），不能留在build/里不动 - 如果用 CMakeLists.txt 管理，直接加一句：
set(CMAKE_EXPORT_COMPILE_COMMANDS ON)，下次cmake ..就自动覆盖旧文件 - 删过
build/或新增了库？记得重新生成，clangd 不会自动刷新这个文件
clang-tidy 或命令行 clang 报 “'xxx.h' file not found”
clang-tidy 默认不继承编译器的头文件搜索逻辑，尤其当你没传完整编译参数时，它连基本 C 标准库都找不到。
- 必须显式告诉它这是 C++ 文件：
-- -x c++（注意前面两个短横线，这是分隔 clang-tidy 参数和底层 clang 参数的关键） - 第三方头文件路径要用
-I一个个加：clang-tidy main.cpp -- -x c++ -I ./thirdparty/opencv/include -I /usr/local/include - 如果路径含空格或特殊字符，
-I后面的路径要加引号，比如-I "/opt/homebrew/include" - Linux 上常见缺
libc6-dev或libstdc++-dev，Ubuntu 下补装：sudo apt install build-essential libc6-dev
Mac 上用源码编译的 clang 找不到 stdio.h
自己从 LLVM 源码编译的 clang 是“裸编译器”，不自带 SDK 路径绑定。它不像系统自带的那样自动调用 xcrun 查 SDK，所以必须手动喂。
- 验证方式：
clang -x c -E -v - ，看输出里 <code>search starts here:下有没有 SDK 路径 - 临时解决：每次编译都加
-isysroot $(xcrun --show-sdk-path) - 一劳永逸：把
export SDKROOT=$(xcrun --show-sdk-path)加进 shell 配置（如~/.zshrc），然后在编译命令里用-isysroot $SDKROOT - 别试图把头文件硬拷到
/usr/local/include—— SDK 里的头文件是带版本和架构标记的，直接复制会破坏兼容性
实际项目里最常被忽略的，是 compile_commands.json 的位置和更新时机。它不是“生成一次就永远有效”的配置文件，而是一份快照。改了 CMakeLists.txt、加了新依赖、清了 build/ 目录，都得重生成——clangd 不会主动提醒你它已经失效。
