1、基础概念概念
（1）交叉编译定义
指在一台主机（Host）上编译出能在另一台不同架构 / 系统的目标机（Target）上运行的程序，
核心解决 “编译环境与运行环境不一致” 的问题（比如 x86 Linux 编译 ARM 嵌入式程序、Windows 编译 Linux 程序）。
（2）核心概念
| 术语 | 说明 | 示例 |
|---|---|---|
| Host | 编译机器（编译工具运行的环境） | x86_64 Ubuntu |
| Target | 程序最终运行的机器 | ARMv7 嵌入式 Linux |
| 交叉编译器 | 针对 Target 架构定制的编译器套件 | arm-linux-gnueabihf-gcc |
| 工具链 | 编译器 + 链接器 + 汇编器 + 库文件的完整集合 | gcc/binutils/glibc |
（3）为什么需要交叉编译
目标机资源受限：嵌入式设备（如单片机、路由器）CPU / 内存小，无法本地编译；
跨平台开发：Windows 开发 Linux 程序、x86 开发 ARM 程序；
效率提升：主机性能远高于目标机，编译速度更快。
2、核心步骤（以 Linux 主机编译 ARM 程序为例）
（1）准备交叉编译工具链工具链是交叉编译的核心，获取方式有 3 种：
a.系统包管理器安装（简单，适合通用架构）
主 流 Linux 发行版可直接安装预编译工具链：
# Ubuntu/Debian 安装ARM32位工具链
sudo apt install gcc-arm-linux-gnueabihf g++-arm-linux-gnueabihf# 验证工具链（输出Target架构则成功）
arm-linux-gnueabihf-gcc -v b.下载厂商定制工具链（适合特定芯片）
芯片厂商（如 NXP、瑞芯微、全志）会提供适配自家芯片的工具链，例如：
# 下载后解压
tar -xvf gcc-arm-10.3-2021.07-x86_64-arm-none-linux-gnueabihf.tar.xz
# 添加到环境变量
export PATH=$PATH:/path/to/toolchain/bin c.手动编译工具链（复杂，适合定制需求）
通过crosstool-NG编译自定义工具链（需熟悉编译参数）：
# 安装依赖
sudo apt install git make gcc g++ patch libtool automake bison flex texinfo
# 下载crosstool-NG
git clone https://github.com/crosstool-ng/crosstool-ng
cd crosstool-ng && ./bootstrap && ./configure --prefix=/opt/ct-ng && make && make install
# 配置并编译工具链（需选择Target架构、内核版本等）
ct-ng armv7-linux-gnueabihf
ct-ng build（2）编写测试代码: 创建hello.c
#include <stdio.h>
int main() {printf("Hello Cross Compile!\n");return 0;
}（3）执行交叉编译: 用交叉编译器替代原生 gcc
# 交叉编译（arm-linux-gnueabihf-gcc 是交叉编译器前缀）
arm-linux-gnueabihf-gcc hello.c -o hello_arm# 验证程序架构（输出ARM架构则成功）
file hello_arm
# 预期输出：hello_arm: ELF 32-bit LSB executable, ARM, EABI5 version 1 (SYSV), ... （4）部署到目标机运行: 将编译后的hello_arm拷贝到 ARM 目标机（如通过 scp、U 盘），执行
# 目标机上运行
chmod +x hello_arm
./hello_arm
# 输出：Hello Cross Compile!3、进阶：项目级交叉编译（CMake 示例）
对于复杂项目，推荐用 CMake 管理交叉编译，步骤如下：
（1）编写交叉编译工具链文件（arm-toolchain.cmake）
# 指定Target系统
set(CMAKE_SYSTEM_NAME Linux)
set(CMAKE_SYSTEM_PROCESSOR ARM)# 指定交叉编译器路径
set(TOOLCHAIN_PATH /usr/bin)
set(CMAKE_C_COMPILER ${TOOLCHAIN_PATH}/arm-linux-gnueabihf-gcc)
set(CMAKE_CXX_COMPILER ${TOOLCHAIN_PATH}/arm-linux-gnueabihf-g++)# 指定Target系统根文件系统（可选，针对嵌入式）
# set(CMAKE_SYSROOT /path/to/arm-rootfs)# 禁用编译器检查（避免主机架构干扰）
set(CMAKE_C_COMPILER_FORCED TRUE)
set(CMAKE_CXX_COMPILER_FORCED TRUE)（2）配置并编译项目
# 创建构建目录
mkdir build && cd build
# 指定工具链文件编译
cmake -DCMAKE_TOOLCHAIN_FILE=../arm-toolchain.cmake ..
# 编译
make4、常见问题与解决
（1）链接错误：找不到 libc.so.6
原因：目标机的 libc 版本与工具链不匹配。解决：
使用与目标机根文件系统匹配的工具链；编译时指定--sysroot指向目标机根文件系统
arm-linux-gnueabihf-gcc hello.c -o hello_arm --sysroot=/path/to/arm-rootfs （2）运行时提示 “exec format error”
原因：程序架构与目标机不匹配（如 ARM64 工具链编译 ARM32 程序）。解决：
确认目标机架构（uname -m）；选择对应架构的工具链（如 arm64 用aarch64-linux-gnu-gcc）。
（3）缺少头文件（如 stdio.h）
原因：工具链未包含 Target 系统的头文件。解决：
安装完整的工具链（包含 sysroot）；手动指定头文件路径：-I/path/to/arm-rootfs/usr/include
（4）常用工具链前缀参考
| 目标架构 | 工具链前缀 | 适用场景 |
|---|---|---|
| ARM32 (硬浮点) | arm-linux-gnueabihf-gcc | 树莓派、ARM 嵌入式 Linux |
| ARM64 | aarch64-linux-gnu-gcc | ARM64 服务器、手机 |
| MIPS | mipsel-linux-gnu-gcc | 路由器（MIPS 架构） |
| Windows (x86) | i686-w64-mingw32-gcc | Linux 编译 Windows 程序 |
（5）总结
交叉编译的核心是匹配工具链与目标机的架构 / 系统 / 库版本，步骤可简化为：
选择适配的交叉工具链；用交叉编译器替代原生编译器；（可选）指定目标机根文件系统；部署到目标机验证
对于嵌入式开发，重点关注工具链与目标机根文件系统的一致性；对于通用跨平台开发，优先使用系统预编译工具链或成熟的第三方工具链（如 musl-cross-make）