CMake交叉编译：将交叉配置移至工具链文件后find_package(Threads)失败的原因排查

我之前也碰到过类似的交叉编译坑，你的问题核心出在CMake加载工具链文件的时机，以及浮点ABI参数没有覆盖到CMake内部的编译检查阶段上。

问题根源 #

当初始把交叉编译配置写在CMakeLists.txt里时，你是在project()命令之后设置的编译选项，此时find_package(Threads)执行时，已经能拿到完整的编译参数（包括-mtune=cortex-a9和浮点ABI设置），所以测试编译能正常通过。

但把配置迁移到toolchain.cmake后，CMake会在project()命令执行前就加载工具链文件，并且会先运行一轮初始编译器兼容性测试。如果你的工具链文件里没有显式指定浮点ABI参数，这轮测试会用默认的软浮点（soft-float）ABI去编译，而你的目标系统用的是硬浮点（hard-float）的arm-linux-gnueabihf，就会出现找不到gnu/stubs-soft.h的错误，最终导致find_package(Threads)判定依赖缺失。

解决方案 #

修改你的toolchain.cmake，确保以下几点：

1. 显式设置浮点ABI和编译参数，并且让它们在CMake初始阶段生效：

   # toolchain.cmake 核心配置
   set(CMAKE_SYSTEM_NAME Linux)
   set(CMAKE_SYSTEM_PROCESSOR arm)
   
   # 指定交叉编译器
   set(CMAKE_C_COMPILER clang)
   set(CMAKE_CXX_COMPILER clang++)
   
   # 显式设置编译器目标和浮点ABI
   set(CMAKE_CXX_COMPILER_TARGET "arm-linux-gnueabihf")
   # 用_INIT变量确保参数在CMake初始编译检查阶段就生效
   set(CMAKE_C_FLAGS_INIT "-mfloat-abi=hard -mtune=cortex-a9")
   set(CMAKE_CXX_FLAGS_INIT "-mfloat-abi=hard -mtune=cortex-a9")
   
   # 设置系统根目录，确保CMake能找到正确的头文件和库
   set(CMAKE_SYSROOT "/usr/arm-linux-gnueabihf")
   
   # 添加编译定义
   add_compile_definitions(_ARM_GCC_)
   

2. 确保工具链文件的加载时机正确：
   执行CMake时，必须通过-DCMAKE_TOOLCHAIN_FILE=toolchain.cmake参数指定工具链文件，不能在CMakeLists.txt里用include()加载（这会错过初始配置阶段）。

额外验证 #

执行编译前，你可以先通过cmake -B build/ -DCMAKE_TOOLCHAIN_FILE=toolchain.cmake -DCMAKE_VERBOSE_MAKEFILE=ON查看初始编译检查的命令，确认是否包含了-mfloat-abi=hard参数。如果看到检查命令里有这个参数，说明配置已经生效。

内容的提问来源于stack exchange，提问作者Zermingore