“file not found”错误源于clang++未正确识别头文件路径，而非代码本身：macOS需Xcode SDK路径，Linux依赖dev包，VSCode中clangd需compile_commands.json或.clangd配置指定-isystem/-I路径。
clang++ 命令行报 “file not found” 是路径没对，不是代码错
这问题几乎不来自你写的 #include <iostream></iostream> 本身，而是 clang++ 根本没看到系统头文件在哪。macOS 自 Mojave 起移除了 /usr/include，所有头文件都打包进 Xcode SDK；Linux 上则依赖 GCC 安装的 libstdc++-dev 或 libc++-dev 包提供路径。直接运行 clang++ -v test.cpp（加 -v），终端会打印出它实际搜索的 -internal-isystem 和 -internal-externc-isystem 路径——这才是真实依据。
- macOS：若输出里没有类似
/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/include/c++/v1的路径，说明 SDK 未被识别 - Linux（Debian/Ubuntu）：若没出现
/usr/include/c++/12或/usr/lib/gcc/x86_64-linux-gnu/12/include/c++，大概率是没装g++或对应版本的 dev 包 - WSL 或自建工具链：
clang++ -print-search-dirs可查默认搜索根目录，再结合find /usr -name "iostream" 2>/dev/null定位真实位置
VSCode 里 clangd 报错但命令行能编译，说明插件没读到编译上下文
VSCode 不会自动继承终端的环境变量或编译参数，clangd 默认只用最简配置启动，不加载项目构建信息。即使你 clang++ 能跑通，clangd 仍可能报 'algorithm' file not found。
- 首选方案：在项目根目录生成
compile_commands.json（CMake 加-DCMAKE_EXPORT_COMPILE_COMMANDS=1，或用bear -- make），clangd 会自动读取其中的command字段来推导 include 路径 - 次选方案：手动配
.clangd文件，写明关键 flag，例如：CompileFlags:<br> Add: [-x, c++, --isystem, /usr/include/c++/12, --isystem, /usr/include/x86_64-linux-gnu/c++/12]
- 避坑点：别只改 VSCode 的
c_cpp_properties.json——那是给 Microsoft C/C++ 插件用的，对 clangd 无效；clangd 只认.clangd或compile_commands.json
用了 Homebrew 的 llvm/clang，却找不到 iostream
Homebrew 安装的 llvm 默认不带 macOS SDK 支持，它不知道去哪找 /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/include。这不是 bug，是设计如此——Homebrew 的 llvm 面向跨平台通用场景，不绑定 Apple 私有 SDK。
- 临时编译：加
-isysroot $(xcrun --show-sdk-path)，例如clang++ -isysroot $(xcrun --show-sdk-path) -std=c++17 test.cpp - VSCode 中生效：在
.clangd里写CompileFlags:<br> Add: [--isysroot, /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk]
（路径用xcrun --show-sdk-path动态查） - 长期省事：卸载
brew uninstall llvm，回归系统自带/usr/bin/clang++，再执行sudo xcode-select --switch /Library/Developer/CommandLineTools
自己写的头文件（如 "myheader.h"）clangd 找不到
这类报错和标准库无关，纯属项目结构未被 clangd 理解。它默认只搜当前文件所在目录和 compile_commands.json 里记录的 -I 路径，不会递归猜你把头文件放哪了。
- 确保
compile_commands.json中对应条目的command字段包含正确的-I，比如-I./include -I../common - 没生成编译数据库？在
.clangd中显式加路径：CompileFlags:<br> Add: [-I, ./include, -I, ../common]
- 路径含空格或符号链接？clangd 对
~、$HOME不展开，必须写绝对路径或相对工作区根目录的路径（如./src/include） - 注意大小写：macOS 默认文件系统不区分大小写，但 clangd 解析路径时严格区分，
#include "MyHeader.h"和文件名myheader.h会失败
真正卡住人的地方，往往不是 clang 本身多难调，而是它默认不假设任何路径——你得明确告诉它“头文件在这儿”，而不是指望它像 IDE 那样自动扫描整个硬盘。路径写错一个斜杠、少一个 -I、或者 compile_commands.json 没放在项目根目录，都会让提示全灭。
