应先查目标板真实架构：cat /proc/cpuinfo | grep "CPU architecture"，ARMv7选arm-linux-gnueabihf，ARMv8/aarch64选aarch64-linux-gnu；再确认浮点ABI（readelf -A /bin/ls），含Tag_ABI_VFP_args:1则用hf后缀；最后安装对应libc-dev-cross包并配置CMake toolchain文件，设CMAKE_SYSTEM_NAME=Linux、CMAKE_SYSTEM_PROCESSOR为arm或aarch64、CMAKE_FIND_ROOT_PATH_MODE_*为ONLY/NEVER。
直接装预编译工具链，别自己编译 GCC；CMake 必须显式设置 CMAKE_SYSTEM_NAME 和 CMAKE_SYSTEM_PROCESSOR，否则 find_package 一定链接错库。
怎么选对 arm-linux-gnueabihf 还是 aarch64-linux-gnu
先查目标板真实架构，别靠型号猜。树莓派 4 是 aarch64，但树莓派 Zero 是 armv6l，硬用 arm-linux-gnueabihf 会报 Illegal instruction。
- 运行
cat /proc/cpuinfo | grep "CPU architecture"：输出ARMv7对应arm，ARMv8或aarch64对应aarch64 - 运行
readelf -A /bin/ls | grep -i abi：含Tag_ABI_VFP_args: 1表示硬浮点，匹配gnueabihf或gnu；若为0，得用gnueabi - 运行
ldd /bin/ls | grep libc：路径含/arm-linux-gnueabihf/就用arm-linux-gnueabihf-，含/aarch64-linux-gnu/就用aarch64-linux-gnu-
Debian/Ubuntu 上装完工具链为什么还缺头文件
因为 gcc-arm-linux-gnueabihf 包只带编译器，不带 sysroot。缺 bits/libc-header-start.h 就是这个原因。
- 必须额外安装
libc6-dev-armhf-cross（ARM32）或libc6-dev-arm64-cross（ARM64） - Debian 系默认 sysroot 在
/usr/arm-linux-gnueabihf/或/usr/aarch64-linux-gnu/，不是/usr/arm-linux-gnueabihf/sysroot - 验证：运行
arm-linux-gnueabihf-g++ -print-sysroot，输出路径要和你 CMake 里CMAKE_SYSROOT一致
CMake toolchain 文件里最容易漏的三处配置
只写 CMAKE_CXX_COMPILER 是无效的，CMake 根本不进入交叉编译模式，find_package(Threads) 仍会去宿主机找 libpthread.so。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
-
CMAKE_SYSTEM_NAME必须设为Linux（不是ARM，也不是Generic） -
CMAKE_SYSTEM_PROCESSOR严格按工具链前缀设：arm-linux-gnueabihf-→arm，aarch64-linux-gnu-→aarch64（大小写敏感） -
CMAKE_FIND_ROOT_PATH_MODE_LIBRARY、CMAKE_FIND_ROOT_PATH_MODE_INCLUDE都得设为ONLY，CMAKE_FIND_ROOT_PATH_MODE_PROGRAM设为NEVER
链接时报 undefined reference to `__aeabi_dadd` 怎么办
这是典型的 ABI 不匹配：工具链用硬浮点（gnueabihf），但编译选项没开硬浮点支持，或者 sysroot 路径下压根没对应 ABI 的库。
- 确认
CMAKE_CXX_FLAGS包含-mfloat-abi=hard（对应gnueabihf）或-mfloat-abi=softfp（对应gnueabi） - 检查
CMAKE_SYSROOT下是否存在usr/lib/arm-linux-gnueabihf/（ARM32）或usr/lib/aarch64-linux-gnu/（ARM64） - 如果用的是自建 sysroot（比如 Buildroot 输出），确保里面包含完整
libstdc++.so和libc.so，且readelf -A显示 ABI tag 一致
最常被忽略的是：CMake 不会自动推导 sysroot 路径，也不会校验 ABI 是否真能对上。哪怕 arm-linux-gnueabihf-g++ --version 能跑，也不代表它能连上正确的 libc —— 错误往往在链接阶段才暴露，而那时已经浪费了半小时编译时间。
