GCC在Debian如何交叉编译

下面以在 Debian 上用 GCC 进行交叉编译为例，按常见场景给你一个清晰、可操作的说明。

一、什么是交叉编译

交叉编译 = 在一种架构的机器上，编译出另一种架构的可执行程序
例如：

x86_64 Debian → 编译 ARM 程序
x86_64 Debian → 编译 RISC-V / MIPS / aarch64 程序

二、Debian 上安装交叉编译工具链（最简单方式）

1️⃣ 查看可用交叉编译器

dpkg --list | grep gcc | grep arm

或搜索：

apt search gcc-arm

2️⃣ 安装常用交叉编译器

ARM 32 位（armhf）

sudo apt update
sudo apt install gcc-arm-linux-gnueabihf

ARM 64 位（aarch64）

sudo apt install gcc-aarch64-linux-gnu

RISC-V 64

sudo apt install gcc-riscv64-linux-gnu

MIPS

sudo apt install gcc-mips-linux-gnu

安装后编译器名称通常是：

arm-linux-gnueabihf-gcc
aarch64-linux-gnu-gcc
riscv64-linux-gnu-gcc

三、基础交叉编译示例

1️⃣ 写测试程序

// hello.c
#include <stdio.h>

int main() {
    printf("Hello Cross Compile\n");
    return 0;
}

2️⃣ 使用交叉编译器编译

ARM 32

arm-linux-gnueabihf-gcc hello.c -o hello_arm

ARM 64

aarch64-linux-gnu-gcc hello.c -o hello_arm64

3️⃣ 确认架构

file hello_arm

输出类似：

ELF 32-bit LSB executable, ARM

四、指定 sysroot（进阶）

当程序依赖目标平台的库时，需要 sysroot：

aarch64-linux-gnu-gcc \
  --sysroot=/path/to/aarch64/sysroot \
  hello.c -o hello

sysroot 通常来自：

目标板文件系统
构建系统（Buildroot / Yocto）

五、CMake 交叉编译（推荐）

1️⃣ 写工具链文件

# toolchain-arm.cmake
SET(CMAKE_SYSTEM_NAME Linux)
SET(CMAKE_C_COMPILER arm-linux-gnueabihf-gcc)
SET(CMAKE_CXX_COMPILER arm-linux-gnueabihf-g++)

2️⃣ 使用 CMake

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

六、常见错误与解决

❌ 找不到头文件

✅ 安装目标头文件：

apt install libstdc++-dev-armhf-cross

❌ 运行时架构不匹配

✅ 确认：

uname -m
file your_binary

七、如果你愿意，我可以继续讲

✅ Debian 交叉编译内核
✅ 使用 crosstool-NG 自定义工具链
✅ Buildroot / Yocto 交叉编译
✅ 静态 vs 动态交叉编译

你可以告诉我：目标平台是什么（ARM？RISC-V？） + 用途（应用 / 内核 / 嵌入式）