必须显式传入CMAKE_TOOLCHAIN_FILE，否则CMake默认本地编译、CMAKE_CROSSCOMPILING为FALSE；toolchain文件至少需设CMAKE_SYSTEM_NAME、CMAKE_SYSTEM_PROCESSOR、CMAKE_C_COMPILER、CMAKE_SYSROOT四变量，缺一将导致链接失败或头文件误引。
交叉编译时 CMAKE_TOOLCHAIN_FILE 必须显式传入
不传 CMAKE_TOOLCHAIN_FILE，CMake 默认走本地编译路径，CMAKE_CROSSCOMPILING 会是 FALSE，哪怕你在 CMakeLists.txt 里硬写 set(CMAKE_C_COMPILER ...) 也大概率失效——尤其遇到 externalproject_add() 或 find_package() 时直接报错找不到编译器。
正确做法是把所有交叉相关配置抽离到独立文件（如 arm64.toolchain.cmake），然后在命令行强制指定：
cmake -S . -B build -DCMAKE_TOOLCHAIN_FILE=arm64.toolchain.cmake- 不能只写
-DCMAKE_C_COMPILER=...参数，那只能覆盖部分变量，无法触发完整交叉上下文 - 工具链文件必须放在项目外或明确路径下，CMake 不会自动搜索它
toolchain.cmake 文件里至少要设这 4 个变量
少任何一个都可能导致链接失败、头文件找不到或 CMAKE_SYSTEM_PROCESSOR 误判为宿主机架构。
-
set(CMAKE_SYSTEM_NAME Linux)：目标系统名，不是宿主机的Linux，而是“你要跑在哪”，常见值还有Windows、Generic（裸机） -
set(CMAKE_SYSTEM_PROCESSOR aarch64)：目标 CPU 架构，不是x86_64，别抄错。ARM32 用arm，ARM64 用aarch64，MIPS 用mips -
set(CMAKE_C_COMPILER /opt/gcc-arm/bin/arm-linux-gnueabihf-gcc)：必须用绝对路径，相对路径在子目录构建时会崩 -
set(CMAKE_SYSROOT /opt/sysroot-armhf)：指向目标平台的根文件系统镜像路径，否则#include <stdio.h>都可能引用到宿主机头文件
交叉编译时 find_package() 容易找不到库
find_package(Threads) 或 find_package(OpenSSL) 在交叉环境下默认查宿主机路径，结果是“找到但链接失败”或“根本找不到”。
- 确保
CMAKE_SYSROOT已设，且目标 sysroot 下有对应库（如$CMAKE_SYSROOT/usr/lib/libpthread.so） - 对第三方库，优先用
find_package(... CONFIG)+ 指定PATHS，例如：find_package(OpenSSL CONFIG PATHS /opt/sysroot-armhf/usr/share/cmake/Modules) - 避免在 toolchain 文件里写
set(CMAKE_FIND_ROOT_PATH ...)后又漏掉CMAKE_FIND_ROOT_PATH_MODE_*，否则头文件和库文件会混查
验证是否真正在交叉编译
光看 CMake 输出 “-- The C compiler identification is GNU” 不够，得确认关键变量和实际行为。
- 构建后检查
build/CMakeCache.txt中：CMAKE_CROSSCOMPILING:BOOL=TRUECMAKE_SYSTEM_NAME:STRING=LinuxCMAKE_SYSTEM_PROCESSOR:STRING=aarch64 - 运行
file build/demo，输出应含ARM aarch64或类似字样，而非ELF 64-bit LSB shared object, x86-64 - 如果
target_link_libraries()链了m却提示undefined reference to `sqrt'，大概率是CMAKE_SYSROOT没生效，链接器用了宿主机的libm.so
最常被跳过的其实是 CMAKE_SYSROOT 和 CMAKE_FIND_ROOT_PATH_MODE_* 的组合设置——它们不报错，但会让整个依赖查找静默失效。
