根本原因是clang未指定--sysroot时按固定顺序搜索头文件：先target-specific路径，再fallback至宿主机/usr/include等；-target仅控制指令生成，不约束头文件和库路径，导致ABI错配。
clang -target 没配 sysroot，头文件路径默认 fallback 到宿主机
根本原因就一条：clang 在没明确指定 --sysroot 时，会按固定顺序搜索头文件：先找 target-specific 路径（比如 aarch64-linux-gnu 相关的），找不到就退回到宿主机系统路径（/usr/include、/usr/local/include 等）。这不是 bug，是设计行为——但对交叉编译来说就是灾难。
你执行 clang -target aarch64-linux-gnu test.c 时，-target 只告诉 clang “生成什么架构的指令”，**不等于**“用什么头文件和库”。它不会自动加载 ARM64 的 libc 头文件，也不会阻止它去读 x86_64 的 stdint.h 或 sys/socket.h。
- 现象：编译通过，但运行时报
undefined symbol: __libc_start_main，或结构体大小错乱（比如off_t在 x86 是 8 字节，在 ARM64 也是 8 字节，但某些嵌入式 libc 里可能是 4 字节） - 验证方法：加
-v参数看实际包含路径：clang -target aarch64-linux-gnu -v -c test.c，输出里会列出所有#include "..."和#include <...>的搜索目录 - 关键区别：
-I只追加路径，不能屏蔽默认路径；--sysroot才是重置整个根目录（包括usr/include和lib）
sysroot 缺失或不完整，导致 clang 主动降级回退
即使你写了 --sysroot=/path/to/arm64-sysroot，如果这个目录下没有 usr/include/stdio.h，或者 usr/include/asm 是空的、链接错了，clang 就会放弃该路径，继续往宿主机路径找。尤其是 asm、linux、bits 这些内核/ABI 相关头文件，缺一个都可能触发 fallback。
- 常见缺失项：
usr/include/asm应该是软链接到asm-generic或目标平台 arch 目录；usr/include/bits必须匹配 glibc 版本（例如 glibc 2.35 需要对应 bits 头文件） - 错误示范：
cp -r /usr/include /path/to/sysroot/usr/—— 这直接把 x86_64 的头文件塞进 ARM64 sysroot，编译能过，运行必崩 - 正确来源：从目标板
rsync -av /usr/include/ user@arm64:/tmp/sysroot/usr/include/，或用官方 SDK 提供的 sysroot（如 Linaro、ARM 官方 toolchain 自带）
CMake 中 find_package 或 include_directories 暴露了宿主机路径
很多 CMakeLists.txt 会写 find_package(Threads) 或 include_directories(${CMAKE_CURRENT_SOURCE_DIR}/include)，这些路径在交叉编译时如果不加约束，会被无差别加入 include search list，优先级甚至高于 sysroot 中的同名头文件。
- 典型陷阱：
find_package(OpenCV)默认找宿主机 OpenCV，而不是目标平台的；它会把/usr/include/opencv4加进去 - 解决办法：必须配合 toolchain file 使用，显式设置
CMAKE_FIND_ROOT_PATH，并启用CMAKE_FIND_ROOT_PATH_MODE_INCLUDE和_MODE_LIBRARY为ONLY - 检查手段：在 CMake 配置后查看
build/CMakeCache.txt，搜INCLUDE_DIRECTORIES，确认里面没有/usr/include类路径
libc++ 与 libstdc++ 混用导致头文件链式污染
LLVM 工具链默认倾向用 libc++，但多数 ARM64 Linux 发行版（如 Ubuntu、Debian）用的是 libstdc++。如果你没加 -stdlib=libstdc++，clang 可能一边用 libc++ 的 string 头文件，一边链接 libstdc++.so，结果 std::string 内存布局不一致，sizeof 都对不上。
- 表现：编译不报错，但
std::string传参时栈被踩、std::vector::push_back崩溃 - 必须显式指定：
clang++ -target aarch64-linux-gnu --sysroot=/path/to/sysroot -stdlib=libstdc++ test.cpp - 额外注意：
libstdc++的头文件必须来自目标平台 sysroot，不能是宿主机的/usr/include/c++/11
bits/types.h，整个二进制的结构体偏移就全乱了。别信“编译过了就行”，得用 readelf -Ws 看符号表、file 看 ELF 架构、ldd（在目标板上）看动态依赖，三者缺一不可。 
