9、Makefile交叉编译：指定CC/AR/LD等变量、交叉编译标志（--sysroot）、实战交叉编译一个C项目

说实话，交叉编译这个话题，我当年刚入行时也踩过不少坑。你想想看，在PC上写代码编译得好好的，一放到嵌入式板子上就各种报错——找不到头文件、链接器报undefined reference、运行时直接段错误……说白了，就是没搞清楚「谁编译、为谁编译」这个核心问题。

这一章，我们就来彻底搞明白Makefile里怎么玩交叉编译。我会从最基础的变量指定讲起，再到--sysroot这个关键标志，最后带大家完整实战一个C项目。

9.1 交叉编译的本质：三组变量

交叉编译，说白了就是「在A机器上编译出能在B机器上运行的程序」。A叫宿主机，B叫目标机。

Makefile里怎么告诉编译器「咱们现在是在交叉编译」？答案就是通过三个核心变量：

• CC：C编译器，比如 arm-linux-gnueabihf-gcc
• AR：归档工具，用于生成静态库，比如 arm-linux-gnueabihf-ar
• LD：链接器，比如 arm-linux-gnueabihf-ld

嗯，这里要注意：很多新手只改CC，忘了AR和LD。结果编译能过，链接或打包静态库时就崩了。我早期就吃过这个亏，折腾了一下午才发现AR还是用的本机的ar。

一个典型的交叉编译Makefile开头长这样：

# 交叉编译工具链前缀
CROSS_COMPILE = arm-linux-gnueabihf-

# 核心工具
CC = $(CROSS_COMPILE)gcc
AR = $(CROSS_COMPILE)ar
LD = $(CROSS_COMPILE)ld
OBJCOPY = $(CROSS_COMPILE)objcopy
SIZE = $(CROSS_COMPILE)size

# 编译标志
CFLAGS = -Wall -O2 -g
LDFLAGS = 

我个人习惯把CROSS_COMPILE单独抽出来，这样换平台时只需要改这一个变量。比如换成aarch64，就改成aarch64-linux-gnu-，其他都不用动。

9.2 --sysroot：解决头文件和库的路径问题

交叉编译时最头疼的问题是什么？头文件和库的路径。

你本机的/usr/include里放的是x86的头文件，目标板用的是ARM的。如果编译器傻乎乎地去本机目录找，肯定找不到，或者找到错的。

--sysroot就是用来解决这个问题的。它告诉编译器：「所有头文件和库的搜索路径，都从这个根目录开始找」。

举个例子：

# 假设你的目标系统根目录在 /opt/arm-rootfs
SYSROOT = /opt/arm-rootfs

CFLAGS += --sysroot=$(SYSROOT)
LDFLAGS += --sysroot=$(SYSROOT)

这样，编译器就会去/opt/arm-rootfs/usr/include找头文件，去/opt/arm-rootfs/usr/lib找库文件。

我曾经接手过一个项目，同事把--sysroot写成了--sys-root，结果编译了一整天全报错找不到stdio.h。嗯，这种细节真的能让人崩溃。

9.3 完整的交叉编译Makefile模板

下面是我在实际项目中常用的模板，你可以直接拿来改：

# 交叉编译Makefile模板
# 使用方式：make CROSS_COMPILE=arm-linux-gnueabihf-

CROSS_COMPILE ?= 
CC = $(CROSS_COMPILE)gcc
AR = $(CROSS_COMPILE)ar
LD = $(CROSS_COMPILE)ld

# 目标系统根目录
SYSROOT ?= /opt/arm-rootfs

# 编译标志
CFLAGS = -Wall -O2 -g --sysroot=$(SYSROOT)
CFLAGS += -I$(SYSROOT)/usr/include
LDFLAGS = --sysroot=$(SYSROOT)
LDFLAGS += -L$(SYSROOT)/usr/lib

# 源文件
SRCS = main.c utils.c gpio.c
OBJS = $(SRCS:.c=.o)
TARGET = app.elf

# 默认目标
all: $(TARGET)

$(TARGET): $(OBJS)
	$(CC) $(LDFLAGS) -o $@ $^ -lpthread -lm

%.o: %.c
	$(CC) $(CFLAGS) -c -o $@ $<

clean:
	rm -f $(OBJS) $(TARGET)

.PHONY: all clean

这里我用了?=，意思是如果用户在命令行没传CROSS_COMPILE，就默认用本机编译。这样同一个Makefile既能本地调试，又能交叉编译。

9.4 实战：交叉编译一个C项目

光说不练假把式。我们来实战一个完整的例子。

9.4.1 项目结构

my_project/
├── Makefile
├── main.c
├── utils.c
├── utils.h
└── gpio.c

9.4.2 源码

main.c

#include <stdio.h>
#include "utils.h"
#include "gpio.h"

int main() {
    printf("Hello from embedded world!\n");
    init_gpio(17);
    set_gpio(17, 1);
    delay_ms(500);
    set_gpio(17, 0);
    return 0;
}

utils.c

#include <unistd.h>
#include "utils.h"

void delay_ms(int ms) {
    usleep(ms * 1000);
}

gpio.c

#include <stdio.h>
#include "gpio.h"

void init_gpio(int pin) {
    printf("GPIO %d initialized\n", pin);
}

void set_gpio(int pin, int value) {
    printf("GPIO %d set to %d\n", pin, value);
}

9.4.3 编译与验证

在宿主机上执行：

# 本地编译（测试用）
make

# 交叉编译
make CROSS_COMPILE=arm-linux-gnueabihf-

# 查看生成的文件类型
file app.elf
# 输出：app.elf: ELF 32-bit LSB executable, ARM, EABI5 version 1 (SYSV)

看到ARM字样，说明交叉编译成功了。

9.5 知识体系总览

下面这张图总结了本章的核心逻辑：

9.6 常见坑与避坑指南

• 工具链版本不匹配：我曾经用gcc 9的工具链去链接gcc 7编译的静态库，结果一堆ABI不兼容的错误。解决办法：整套工具链统一版本。
• 忘记指定--sysroot：编译器会去本机的/usr/include找头文件，找到的是x86的，编译出来要么报错，要么运行崩溃。
• 硬编码路径：不要在Makefile里写死/home/user/xxx这种路径。用变量，用相对路径，或者从环境变量读取。
• 忽略AR和LD：只改CC不改AR，静态库打包时用的还是本机工具，生成的.a文件目标架构不对。

好了，这一章的内容就到这里。交叉编译说白了就是「换一套工具，指对路径」。掌握了CC/AR/LD和--sysroot，大部分嵌入式项目的编译问题都能迎刃而解。

---

公众号:蓝海资料掘金营，微信deep3321