clang++报“fatal error: 'iostream' file not found”是因未找到c++标准库头文件路径；macos需先运行xcode-select --install并确认apple clang版本，仍失败则手动加-i指定sdk中libc++头文件路径，linux需安装libc++-dev等对应开发包。
clang 命令行编译失败：找不到 iostream 或报错 fatal error: 'iostream' file not found
这不是 clang 本身的问题，而是它没找到 C++ 标准库头文件路径。macOS 上 clang++ 默认用 libc++，但只装了 Xcode 命令行工具（xcode-select --install）时，头文件位置可能未被自动识别；Linux 上则常因没装 libc++-dev 或 libstdc++-dev 导致。
实操建议：
Clang 22.1.3
下载
Clang 22.1.3 Windows 64 位历史版本安装包，适合旧项目兼容、LLVM/Clang 工具链回退、编译行为对比、链接问题复现和 C/C++ 构建环境维护。
- macOS：确保已运行
xcode-select --install，再执行clang++ --version确认输出含Apple clang字样；若仍报错，手动加路径：clang++ -std=c++17 -I/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/include/c++/v1 hello.cpp -o hello - Ubuntu/Debian：安装标准库支持：
sudo apt install libc++-18-dev libc++abi-18-dev（对应 clang-18），或更通用的sudo apt install build-essential - 不要混用
clang和clang++：写 C++ 代码必须用clang++启动，否则链接器不会自动拉 libc++，即使加了-stdlib=libc++也容易漏符号
CMakeLists.txt 中指定 clang 失效：CMake 仍调用 gcc
CMake 不会自动读取系统 PATH 里的 clang，也不认 CC/CXX 环境变量（除非在首次配置前就设好）。常见现象是：改了 set(CMAKE_CXX_COMPILER clang++)，但 cmake .. 日志里仍显示 Detected GNU GCC。
实操建议：
- 删掉构建目录（如
rm -rf out/build/clang），重新用预设方式配置：cmake --preset clang（依赖CMakePresets.json中的cacheVariables显式声明） - 在
CMakePresets.json的configurePresets里补全编译器路径："cacheVariables": { "CMAKE_C_COMPILER": "/usr/bin/clang", "CMAKE_CXX_COMPILER": "/usr/bin/clang++" } - 避免在
CMakeLists.txt里用set(...)覆盖编译器——CMake 规范要求编译器必须在 configure 阶段确定，运行时 set 无效
VS Code 调试时断点不命中、launch.json 配置后仍提示 No executable specified
根本原因是：CMake Tools 插件生成的可执行文件路径没被 C/C++ 扩展识别，或者调试器启动时找不到符号表（debug info 缺失）。
实操建议：
- 确保 CMake 构建类型为
Debug：在CMakePresets.json的configurePresets中加"cacheVariables": { "CMAKE_BUILD_TYPE": "Debug" }，否则默认是RelWithDebInfo，部分优化会干扰调试 -
launch.json的program字段必须写绝对路径，不能用${fileDirname}这类变量——CMake 输出路径固定为out/build/clang/下的可执行名，例如："program": "${workspaceFolder}/out/build/clang/main" - 检查生成的可执行文件是否含调试信息：
file out/build/clang/main应输出with debug_info；若无，确认 CMakeLists.txt 有set(CMAKE_CXX_FLAGS_DEBUG "-g")或更稳妥地用set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -g")
clangd 补全卡顿、跳转定义失效、indexing... 长时间不结束
clangd 默认只索引当前打开的文件及其直接 include，对跨目录、自定义头文件路径或 CMake 生成的构建目录不敏感。常见于项目有 src/、include/ 分离，或用了 target_include_directories() 但没同步给 clangd。
实操建议：
- 在项目根目录放
compile_commands.json：用 CMake 生成它——运行cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON --preset clang，然后让 clangd 自动加载（VS Code 的 C/C++ 扩展默认支持） - 禁用冗余索引：在 VS Code 设置中搜
clangd.arguments，添加--limit-results=500和--background-index，避免卡死 - 别把
out/或build/加进工作区：这些目录含大量中间文件，clangd 会试图解析它们，拖慢响应；用.vscode/settings.json排除："files.exclude": { "**/out": true, "**/build": true }
CMAKE_BUILD_TYPE，也可能让 clangd 索引失效、lldb 断点飘移、甚至 clang-tidy 报出完全无关的警告——这些都不是配置错误，而是 LLVM 生态里“约定优于配置”留下的缝隙。
