“file not recognized: file format not recognized”根本原因是目标文件或库格式与链接器不兼容，最常见为LLVM LTO生成bitcode而GNU ld无法识别，需改用lld链接器并确保平台匹配、路径正确。
clang链接时报“file not recognized: file format not recognized”
这不是头文件问题，是目标文件或库文件格式与当前链接器不兼容。最常见原因是LLVM LTO生成了bitcode，但链接器用的是GNU ld。
- 先用
file命令检查报错的.o或.so文件：file CMakeFiles/main.dir/src/main.cc.o—— 如果输出含LLVM IR bitcode，说明LTO已启用 - 必须改用LLVM自家的链接器
lld：在CMake中加set(CMAKE_EXE_LINKER_FLAGS "-fuse-ld=lld")，或编译时显式传-fuse-ld=lld - 若用
ccache，确保它不缓存bitcode文件；可临时禁用ccache验证是否为缓存干扰 - 不要试图用
objcopy转格式——bitcode不是标准ELF，无法简单转换
clang++编译时报“'iostream' file not found”
Clang本身不带标准库头文件，必须显式告诉它在哪找。错误不是代码写错了，是路径没配对。
- macOS上：缺
-isysroot参数，运行xcrun --show-sdk-path拿到路径后，加-isysroot $(xcrun --show-sdk-path)；或者卸载Homebrew版llvm，用系统自带Clang（sudo xcode-select --switch /Library/Developer/CommandLineTools） - Ubuntu/Debian：缺libstdc++开发包，装
g++和libc++-dev（sudo apt install g++ libc++-dev） - Windows（用clang++而非clang-cl）：必须指定
--target=x86_64-pc-windows-msvc，且确保VCINSTALLDIR和WindowsSdkDir环境变量已由VS Build Tools设好
clangd提示“pp_file_not_found”但编译能过
编辑器补全失效，而命令行编译正常——这是clangd没读到真实编译参数，只靠硬编码includePath撑不住复杂项目。
- clangd只认
compile_commands.json，不读CMakeLists.txt或c_cpp_properties.json里的includePath - 在build目录执行
cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON ..，生成compile_commands.json - Clangd v10及更早版本要求该文件放在项目根目录；v12+可放build/下，但VSCode里仍需在
c_cpp_properties.json中用"compileCommands"字段明确指向它，例如："compileCommands": "${workspaceFolder}/build/compile_commands.json" - 别指望改
browse.path或includePath绕过去——clangd会直接忽略
libclang.so报“file format not recognized”
这通常发生在跨平台搬运预编译LLVM二进制包时，比如Windows下载、Linux解压使用。
-
file /path/to/libclang.so会显示ELF64-bit LSB shared object, x86-64之类——如果输出是data或格式混乱，基本就是平台错配 - 预编译包必须在目标平台解压安装；Windows下的tar.gz直接扔到Linux里解压，so文件可能损坏或架构不匹配
- 推荐用包管理器安装（如Ubuntu用
apt install libclang-12-dev），或从LLVM官网下载对应平台的tar.xz - 检查
LD_LIBRARY_PATH是否误指了其他版本的libclang.so
