clang的-target三元组隐式决定abi，如gnueabihf表示gnu libc+eabi+hard-float；abi不匹配会导致链接时undefined reference到__aeabi_*符号，需确保-target、-mfloat-abi、--sysroot及工具链specs严格一致。
clang -target 三元组里就藏着 ABI 信息
ABI 不是独立配置项，它由 -target 指定的三元组隐式决定。比如 armv7a-unknown-linux-gnueabihf 中的 gnueabihf 就明确表示：GNU libc + EABI + hard-float；而 armv7a-unknown-linux-gnueabi（无 hf）对应 soft-float。clang 不会接受模糊写法，arm-linux-gnueabihf 或 armv7-linux-gnueabihf 都会报 error: unable to create target。
硬浮点 vs 软浮点：链接失败时先查这个
常见报错 undefined reference to '__aeabi_dadd' 或 __aeabi_uidiv，基本可断定是 ABI 混用：一个模块用 -mfloat-abi=hard 编译，另一个用 soft 或 softfp 编译，导致浮点调用约定不兼容。这种问题不会在编译时报错，只在链接或运行时暴露。
-
-mfloat-abi=hard：浮点参数走 VFP/NEON 寄存器，调用符号不带__aeabi_*前缀 -
-mfloat-abi=soft：所有浮点运算转成函数调用，依赖libgcc提供的__aeabi_*符号 -
-mfloat-abi=softfp：指令用硬件，但参数仍走整数寄存器（兼容 soft ABI），符号名和 soft 一致
sysroot 和工具链必须与 ABI 严格对齐
就算 -target 写对、-mfloat-abi 设准，如果 --sysroot 里的 libc 是 gnueabi 版本，而你用 gnueabihf 三元组，照样会链接失败——libm.so 路径可能对不上，printf 的符号版本也可能不匹配。
- 检查 sysroot 是否含
lib/arm-linux-gnueabihf/这类 ABI-specific 子目录 - 用
readelf -A查看目标库的属性：Tag_ABI_VFP_args: VFP registers表示 hard-float - 交叉工具链（如
aarch64-linux-gnu-gcc）默认 ABI 可通过aarch64-linux-gnu-gcc -dumpspecs | grep float确认
CMake Presets 里不能只靠 cacheVariables 猜 ABI
很多 preset 文件只设了 CMAKE_SYSTEM_PROCESSOR 和 CMAKE_TOOLCHAIN_FILE，却没显式约束 ABI 行为，结果不同开发者本地构建出 ABI 不一致的二进制。真正可靠的 preset 必须在工具链文件（.cmake）中固化 ABI 相关标志：
- 在
set(CMAKE_C_FLAGS "...")中硬编码--target=...和-mfloat-abi=... - 避免仅靠
CMAKE_SYSTEM_NAME推导 ABI，Linux 可对应 gnueabi/gnueabihf/musleabi 多种变体 - 若用
find_package(Threads)，需确认CMAKE_FIND_ROOT_PATH_MODE_PACKAGE设为ONLY，否则可能混入 host 的 pthread 库
-target、-mfloat-abi、sysroot 路径、工具链 specs、CMake 工具链文件的完整链条。漏掉任意一环，都可能让程序编译通过却在目标机上段错误或链接失败。
