Clang报“'iostream' file not found”不是编译器故障，而是未显式指定标准库头文件路径；其根本原因是Clang不自带完整工具链，需依赖系统或第三方提供的头文件和库，且必须通过-I、-isysroot、--target等参数显式配置路径。
不是编译器坏了，是它根本没被告知库在哪——Clang默认不猜路径，必须显式告诉它。
clang++ 编译时报 “'iostream' file not found”
这不是代码问题，是 Clang 没找到标准库头文件。macOS、Linux、Windows 三地表现不同，但根因一致：Clang 不自带完整工具链，依赖系统或第三方提供的头文件和库。
- macOS 上常见于未装命令行工具（
xcode-select --install）或误用 Homebrewllvm导致-isysroot缺失；验证用clang++ -v -E -x c++ /dev/null看输出里的#include <...> search starts here:</...>部分 - Ubuntu/Debian 系统常因没装
g++或libc++-dev，运行sudo apt install g++ libc++-dev即可补全路径；Clang 默认走 libstdc++，不是 libc++ - Windows 下若用
clang++（非clang-cl），必须加--target=x86_64-pc-windows-msvc并确保VCINSTALLDIR和WindowsSdkDir环境变量已由 VS Build Tools 设置好
clangd 提示找不到第三方库（如 OpenCV、Boost）
clangd 不读 CMakeLists.txt，只认 compile_commands.json —— 它是唯一能告诉 clangd “这个源文件该用哪些 -I、-D、-stdlib=” 的文件。
Clang 22.1.3
下载
Clang 22.1.3 Windows 64 位历史版本安装包，适合旧项目兼容、LLVM/Clang 工具链回退、编译行为对比、链接问题复现和 C/C++ 构建环境维护。
- 确保你在项目根目录下建了
build/，然后在其中执行：cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON .. - 生成的
compile_commands.json必须放在项目根目录或build/下，并在 VSCode 的c_cpp_properties.json中通过"compileCommands"字段指向它，例如："compileCommands": "${workspaceFolder}/build/compile_commands.json" - 别指望改
includePath列表硬编码路径来绕过这个文件——clangd 会忽略那些，它只信任 compile_commands.json 里每条命令的真实参数
链接阶段报 “undefined reference to xxx”
头文件找到了，但链接器找不到实现，说明库没被传给 linker，或者路径/名字对不上。
- Clang 不自动链接标准库以外的任何东西。调用
sqrt()？得加-lm；用 pthread？得加-lpthread - 第三方静态库（
.a）要放在命令行靠后位置，且需配-L/path/to/lib+-lxxx；顺序错（比如-lxxx放-L前）会导致链接器跳过 - 若用 CMake，别在
target_link_libraries()里只写库名（如OpenCV），应写全名（opencv_core）或用find_package(OpenCV)后接${OpenCV_LIBS}，否则生成的compile_commands.json里不会带-lopencv_core
clang-tidy 报 “file not found”
clang-tidy 不复用你的构建配置，它自己启动一个 Clang 实例，所以所有路径都得重传。
- 必须用
--分隔 clang-tidy 参数和编译参数，例如：clang-tidy foo.cpp -- -x c++ -I/path/to/headers -I/usr/include/c++/11 -
-x c++很关键：不加的话，clang-tidy 默认当 C 文件处理，不会查 C++ 标准库路径 - 如果项目用 CMake，推荐直接用
run-clang-tidy脚本（LLVM 自带），它会自动从compile_commands.json提取完整参数，省去手动拼接
最容易被忽略的是：Clang 本身不管理路径，它只忠实执行你给的参数。所谓“配置环境”，本质就是把 -I、-isysroot、-L、-l 这些开关，准确塞进每个工具（clang++、clangd、clang-tidy）的每次调用里——漏一个环节，就断一环。
