交叉编译是在一个平台上生成另一个平台的可执行文件，CMake通过toolchain文件配置目标系统、编译器和查找路径，结合交叉工具链实现C++项目在不同架构（如ARM）上的构建。

在使用 C++ 开发时，如果需要将程序编译到不同于开发主机的平台（如嵌入式设备、ARM Linux 系统等），就需要进行交叉编译。CMake 是一个强大的跨平台构建系统，支持灵活配置交叉编译环境。下面介绍如何在 CMake 中实现 C++ 项目的交叉编译。

什么是交叉编译

交叉编译是指在一个平台上生成另一个平台可运行的可执行文件。例如，在 x86_64 的 Linux 主机上编译出能在 ARM 架构的嵌入式设备上运行的程序。这在嵌入式开发、移动开发中非常常见。

准备交叉编译工具链

要进行交叉编译，首先需要一个针对目标平台的工具链（toolchain），通常包括：

• 交叉编译器：如 arm-linux-gnueabihf-gcc 和 arm-linux-gnueabihf-g++
• 链接器、汇编器 和其他配套工具
• 目标平台的系统库和头文件

安装工具链的方式因平台而异。例如在 Ubuntu 上安装 ARM 工具链：

sudo apt install gcc-arm-linux-gnueabihf g++-arm-linux-gnueabihf

编写 Toolchain 文件

CMake 使用 toolchain 文件来指定交叉编译所需的参数。创建一个名为 arm-toolchain.cmake 的文件：

arm-toolchain.cmake
set(CMAKE_SYSTEM_NAME Linux)
set(CMAKE_SYSTEM_PROCESSOR arm)
指定交叉编译器路径（根据实际安装位置调整）
set(CMAKE_C_COMPILER arm-linux-gnueabihf-gcc)
set(CMAKE_CXX_COMPILER arm-linux-gnueabihf-g++)
搜索路径设置
set(CMAKE_FIND_ROOT_PATH /usr/arm-linux-gnueabihf)
只在目标环境中搜索库和头文件
set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)

这个文件告诉 CMake：

• 目标系统是 Linux，架构是 ARM
• 使用指定的交叉编译器
• 库和头文件在目标系统路径下查找

使用 CMake 进行交叉编译

在项目根目录下有一个简单的 C++ 项目，结构如下：

.
├── CMakeLists.txt
└── main.cpp

CMakeLists.txt 内容：

cmake_minimum_required(VERSION 3.10)
project(MyApp LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 17)
add_executable(myapp main.cpp)

接下来创建构建目录并指定 toolchain 文件：

mkdir build && cd build
cmake .. -DCMAKE_TOOLCHAIN_FILE=../arm-toolchain.cmake
make

如果一切正常，生成的可执行文件就是为 ARM 平台编译的。可以用 file 命令验证：

file myapp

输出应包含类似：ELF 32-bit LSB executable, ARM，说明交叉编译成功。

常见问题与注意事项

• 找不到库或头文件：确保目标平台的 sysroot 路径正确，并通过 CMAKE_FIND_ROOT_PATH 指定
• 编译器无法执行：检查工具链是否安装完整，权限是否正常
• 动态库链接失败：可能需要在链接时指定 sysroot：-Wl,--sysroot=/path/to/sysroot
• 静态编译更简单：对于嵌入式设备，建议使用静态链接避免依赖问题，可在 CMake 中添加：

  set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -static")

总结

CMake 的交叉编译机制依赖于 toolchain 文件来定义目标平台和编译工具。只要正确配置编译器路径、系统类型和查找规则，就能顺利实现 C++ 项目的跨平台构建。关键是准备好工具链，并确保头文件和库可用。这种方法适用于各种嵌入式 Linux、RTOS 或自定义硬件平台。

基本上就这些，不复杂但容易忽略细节。