🐧 linux-02 交叉编译是什么？给 ARM 单片机编译程序的第一步

🐧 Linux 上手 · 第 2 / 2 章

💬 你在 PC 上 gcc hello.c 生成的程序，拷到 STM32 上连影子都跑不出来——CPU 说的是不同的"方言"。

一、案发现场：编译没问题，运行全乱套

你在 Linux 电脑上写了个最简单的 C 程序，编译运行一气呵成：

# 写代码
$ cat hello.c
int main() { return 42; }

# 编译 + 运行
$ gcc hello.c -o hello
$ ./hello; echo $?
42

你觉得很简单。然后把同一个 hello 文件拷到 STM32 开发板上运行，收获一行：

-sh: ./hello: cannot execute binary file: Exec format error

或者更干脆——板子根本就没有 shell，你的程序得通过 J-Link/STLink 烧到 Flash 里去。这时候你打开 STM32 的工程，发现别人用的编译器叫 arm-none-eabi-gcc，而不是你电脑上的 gcc。

二、本机编译 vs 交叉编译：一张图看懂

「交叉编译」听起来很高深，其实就是：在 A 机器上编译，拿去 B 机器上运行。A 叫「宿主机（Host）」，B 叫「目标机（Target）」。

日常用电脑开发单片机，就是典型的交叉编译场景：你的 Linux 电脑是宿主机，STM32/FPGA 板子是目标机。

三、工具链里到底有什么

你可能会看到「工具链（Toolchain）」这个词。它不是一个程序，而是一组工具的集合，像流水线一样把源代码变成可执行文件。核心成员有四位：

工具	干什么	类比
arm-none-eabi-gcc	编译器，把 .c 翻译成汇编	翻译官
arm-none-eabi-ld	链接器，把多个 .o 拼成最终程序	装订工
arm-none-eabi-objcopy	格式转换，把 ELF 变成 .bin/.hex	打包员
arm-none-eabi-gdb	调试器，配合 J-Link 单步调试	质检员

四、安装 ARM GCC 工具链

在 Ubuntu / OpenCloudOS 上，一行命令就能装好裸机开发的工具链：

# Debian / Ubuntu 系
$ sudo apt install gcc-arm-none-eabi

# 或者直接下载官方预编译包（版本更新）
$ wget https://developer.arm.com/-/media/Files/downloads/gnu/13.2.rel1/binrel/arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-eabi.tar.xz
$ sudo tar xf arm-gnu-toolchain-*.tar.xz -C /opt/

# 加到 PATH
$ echo 'export PATH="/opt/arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-eabi/bin:$PATH"' >> ~/.bashrc
$ source ~/.bashrc

装完验证一下：

$ arm-none-eabi-gcc --version
arm-none-eabi-gcc (Arm GNU Toolchain 13.2.Rel1) 13.2.1
$ arm-none-eabi-gcc -print-multi-lib
.;m32; thumb;/arm/thumb/v7-m;--specs=nosys.specs ...

看到版本号就说明安装成功。-print-multi-lib 列出了支持的各种 CPU 子架构，Cortex-M3/M4/M7 都在里面。

五、第一次交叉编译

我们来编译一个最小程序，确认工具链能跑通：

# hello.c —— 一个不需要操作系统的裸机程序
$ cat hello.c
volatile unsigned int *reg = (void*)0x48000000;
int main() {
    *reg = 0x42;  // 往地址 0x48000000 写一个值
    while(1);     // 裸机程序不能 return
}

# 编译（只编译不链接，先看能不能翻译成功）
$ arm-none-eabi-gcc -c hello.c -mcpu=cortex-m4 -mthumb -o hello.o

# 检查：生成的是 ARM 指令吗？
$ arm-none-eabi-objdump -d hello.o
hello.o:     file format elf32-littlearm
...
00000000 <main>:
   0:	movs	r1, #66	; 0x42
   2:	ldr	r3, [pc, #4]
   4:	str	r1, [r3, #0]
   6:	b	6 <main+0x6>	; while(1) 死循环

看到 movs、ldr、str、b 这些就是 ARM Thumb 指令——你的 C 代码已经被成功翻译成单片机能懂的"方言"了。

六、编译的四个阶段：从 .c 到 .elf

你敲一行 gcc hello.c -o hello，背后其实跑了四道工序。理解这四步，以后报错信息就知道出在哪一环：

平时 gcc hello.c -o hello 一口气跑完四步，但加参数就能在任意一步停下来：

# 只做预处理（展开宏和头文件）
$ arm-none-eabi-gcc -E hello.c -o hello.i

# 只做编译（C → 汇编，调试优化问题时很有用）
$ arm-none-eabi-gcc -S hello.c -o hello.s

# 只做汇编（汇编 → 目标码）
$ arm-none-eabi-gcc -c hello.c -o hello.o

# 链接 + 转格式
$ arm-none-eabi-gcc hello.o -nostdlib -T linker.ld -o hello.elf
$ arm-none-eabi-objcopy -O binary hello.elf hello.bin

七、Makefile 入门：告别手敲五行命令

每次编译都要敲一长串命令太累。make 就是个自动化助手：你把命令写成 Makefile，以后只要敲 make 就行。

先看一个最小 Makefile：

# Makefile —— 最小交叉编译示例
CC = arm-none-eabi-gcc
CFLAGS = -mcpu=cortex-m4 -mthumb -O2 -Wall

hello.elf: hello.c
	$(CC) $(CFLAGS) hello.c -nostdlib -T linker.ld -o hello.elf

flash: hello.elf
	arm-none-eabi-objcopy -O binary hello.elf hello.bin
	st-flash write hello.bin 0x08000000

clean:
	rm -f hello.o hello.elf hello.bin

用法很简单：

$ make          # 编译 hello.elf
$ make flash    # 转 bin + 烧录
$ make clean    # 清理中间文件

Makefile 的核心逻辑是依赖关系：hello.elf 依赖 hello.c，只有 hello.c 被修改过才会重新编译。这就避免了每次都全量编译。

八、3 个新手必踩的坑

九、小测验