Clang报“'iostream' file not found”是因未显式指定头文件路径，clang++可手动加-I/-isysroot编译成功，但clangd只信任compile_commands.json中的真实参数，不读CMakeLists.txt或includePath配置，故需确保该文件生成并被VSCode正确指向。
Clang 报 'iostream' file not found，不是代码错了，是它根本没被告知头文件在哪——Clang 不猜路径，必须显式告诉它。
为什么 clang++ 能编译成功但 clangd 仍飘红
clangd 不读 CMakeLists.txt 或 includePath 配置，只信任 compile_commands.json 里每条命令的真实参数。即使你 cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON .. 成功生成了该文件，如果 VSCode 没指向它，clangd 就会按默认空路径搜，必然失败。
- 确保
compile_commands.json在项目根目录或build/下（推荐放根目录） - 在
.vscode/c_cpp_properties.json中配"compileCommands"字段，例如："compileCommands": "${workspaceFolder}/compile_commands.json" - 别手动往
"browse.path"里硬塞路径——clangd 会忽略 - 改完后必须重启 VSCode 窗口，不是重载窗口
macOS 上 clang++ 找不到系统头文件的典型原因
macOS 自 Mojave 起移除了 /usr/include，所有头文件都打包进 SDK，而 Clang 必须通过 -isysroot 指向它才能访问。Homebrew 安装的 llvm 默认不带这个参数，就会直接报错。
- 验证当前 SDK 路径：
xcrun --show-sdk-path - 临时修复编译命令：
clang++ -isysroot $(xcrun --show-sdk-path) main.cpp - 长期方案：卸载 Homebrew 的 llvm（
brew uninstall llvm），改用系统自带工具链，再执行sudo xcode-select --reset - 若必须用 Homebrew llvm，在 VSCode 的
c_cpp_properties.json中加"compilerArgs": ["-isysroot", "$(xcrun --show-sdk-path)"]
Ubuntu/Debian 下 clang++ 编译报标准库头文件缺失
Clang 默认走 libstdc++，依赖 GCC 提供的头文件和运行时库。只装 clang 不够，g++ 和对应开发包才是关键。
Clang 22.1.3 Windows 64 位历史版本安装包，适合旧项目兼容、LLVM/Clang 工具链回退、编译行为对比、链接问题复现和 C/C++ 构建环境维护。
- 先检查是否安装完整：
dpkg -l | grep -E "(g\+\+|libc\+\+)" - 补全必备包：
sudo apt install g++ libc++-dev libc++abi-dev - 验证搜索路径：
clang++ -v -E -x c++ /dev/null 2>&1 | grep "search starts here:" -A 5 - 若路径里缺
/usr/include/c++/11（或对应版本），说明g++版本不匹配，需sudo apt install g++-11并设为默认
Windows + MSYS2/MinGW 环境下 clang 找不到头文件
Clang 在 Windows 上不自带工具链，必须靠 --target 显式指定目标平台，并让 linker 和 frontend 同步使用同一套头文件与库。用 clang++ 直接编译却不加 target，大概率失败。
- 确认你用的是 MSYS2 的
ucrt64工具链，对应 target 是x86_64-pc-windows-msvc还是x86_64-w64-mingw32？查gcc -v输出里的Target:行 - 编译时必须加：
clang++ --target=x86_64-w64-mingw32 main.cpp - clangd 若仍报错，检查
where clangd返回路径是否和你clang++所在路径一致；不一致就手动在.vscode/settings.json中配"clangd.path" - MSYS2 用户注意：
clangd必须从对应子环境（如ucrt64shell）启动，否则找不到sysroot
最常被忽略的一点：clangd 的行为和 clang++ 命令行完全解耦，它不会继承 shell 环境变量、不会读 CMake 变量、也不会 fallback 到系统默认路径。你看到的“能编译但不提示”，几乎全是 compile_commands.json 没生效或路径不对导致的。
