2. Makefile基础入门：从零开始构建你的第一个自动化项目

大家好，我是你们的老朋友。今天咱们来聊聊Makefile最基础的东西——目标、依赖和规则。说实话，我刚开始接触嵌入式开发时，觉得Makefile就是个黑魔法，一堆奇怪的符号和缩进。但用久了你会发现，它其实就是一套「告诉编译器怎么干活」的脚本语言。

2.1 为什么你需要学Makefile？

你想想看，一个嵌入式项目少说也有几十个源文件。每次改一行代码，难道要手动敲一遍gcc命令？我当年在做一个STM32项目时，就因为忘了重新编译某个模块，调试了整整一个下午。后来才发现，改的是a.c，但链接的还是旧的a.o。嗯，从那以后，我再也不敢不用Makefile了。

Makefile的核心价值就三个字：自动化。它帮你做三件事：

  • 只编译修改过的文件——节省时间
  • 自动处理依赖关系——避免漏编译
  • 统一构建流程——团队协作不出错

核心概念：Makefile本质上是一个「依赖关系图」。你告诉make工具：要生成A，需要先有B和C；要生成B，需要先有D。make会自动帮你按顺序执行。

2.2 Makefile的基本语法

一个最简单的Makefile规则长这样：

目标(target): 依赖(prerequisites)
    规则(recipe)

注意！规则前面那个必须是一个Tab键，不能是空格。我见过太多新手在这里栽跟头了——包括我自己。第一次写Makefile时，我用了4个空格，结果make报了个莫名其妙的错误，查了半天才发现是缩进问题。

2.2.1 目标（Target）

目标就是你要生成的东西。通常是一个文件，比如可执行文件、目标文件(.o)、库文件(.a/.so)。也可以是一个「伪目标」，比如clean、all，它们不代表实际文件。

# 这是一个真实目标——生成可执行文件
main.elf: main.o uart.o
    arm-none-eabi-gcc -o main.elf main.o uart.o

# 这是一个伪目标——只执行动作，不生成文件
clean:
    rm -f *.o *.elf

2.2.2 依赖（Prerequisites）

依赖就是构建目标所需要的「原材料」。如果任何一个依赖比目标更新（修改时间更晚），make就会重新执行规则。

我个人习惯把依赖分成两类：

  • 直接依赖：编译这个文件直接需要的头文件、源文件
  • 间接依赖：被包含的头文件又引用了其他头文件

举个例子：

# main.o 依赖 main.c 和 config.h
main.o: main.c config.h
    gcc -c main.c -o main.o

如果config.h改了，main.o会重新编译。但如果你忘了写config.h这个依赖，改了头文件也不会重新编译——这就是经典的「改了头文件没生效」问题。

2.2.3 规则（Recipe）

规则就是具体的shell命令。可以写多行，每行前面都要有一个Tab。如果某行命令很长，可以用反斜杠\换行：

main.elf: main.o uart.o i2c.o
    arm-none-eabi-gcc -o main.elf \
        main.o uart.o i2c.o \
        -lm -L./libs -lmyutils

小技巧：在规则前面加@可以静默执行，不打印命令本身。比如@echo "编译完成"只会输出「编译完成」，不会显示echo命令。我一般在做CI/CD脚本时喜欢用这个，让输出更干净。

2.3 第一个Hello World Makefile

光说不练假把式。咱们来写一个真正的嵌入式Hello World。假设你有三个文件：

main.c

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

int main() {
    uart_init(115200);
    uart_send("Hello, Embedded World!\n");
    return 0;
}

uart.h

#ifndef UART_H
#define UART_H

void uart_init(int baud);
void uart_send(const char *str);

#endif

uart.c

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

void uart_init(int baud) {
    printf("UART initialized at %d baud\n", baud);
}

void uart_send(const char *str) {
    printf("UART send: %s\n", str);
}

现在，写一个Makefile来编译它们：

# 编译器
CC = gcc
# 编译选项
CFLAGS = -Wall -O2
# 目标文件
TARGET = hello.elf

# 默认目标
all: $(TARGET)

# 链接
$(TARGET): main.o uart.o
    $(CC) -o $(TARGET) main.o uart.o

# 编译 main.o
main.o: main.c uart.h
    $(CC) $(CFLAGS) -c main.c -o main.o

# 编译 uart.o
uart.o: uart.c uart.h
    $(CC) $(CFLAGS) -c uart.c -o uart.o

# 清理
clean:
    rm -f *.o $(TARGET)

# 伪目标声明
.PHONY: all clean

在终端里执行make，你会看到：

$ make
gcc -Wall -O2 -c main.c -o main.o
gcc -Wall -O2 -c uart.c -o uart.o
gcc -o hello.elf main.o uart.o

再执行一次make：

$ make
make: 'hello.elf' is up to date.

看到了吗？第二次没有重新编译，因为所有源文件都没改过。这就是Makefile的智能之处。

注意：如果你改了uart.h，make会自动重新编译main.o和uart.o。但如果你在main.c里#include了某个头文件却没写在依赖里，make就不知道要重新编译。我曾经在一个项目中漏写了某个头文件依赖，结果改了头文件后，有3个.c文件没重新编译，链接出来的程序行为诡异，查了整整两天才找到原因。

2.4 变量与自动变量

上面的Makefile虽然能用，但写得很啰嗦。咱们可以用变量来简化：

CC = gcc
CFLAGS = -Wall -O2
TARGET = hello.elf
OBJS = main.o uart.o

all: $(TARGET)

$(TARGET): $(OBJS)
    $(CC) -o $@ $^

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

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

.PHONY: all clean

这里用到了几个自动变量：

变量 含义 例子
$@ 目标文件名 hello.elf
$< 第一个依赖 main.c
$^ 所有依赖 main.o uart.o
$? 比目标新的依赖 （用于增量编译）

我个人最喜欢$@和$^，它们让规则变得非常简洁。你想想看，如果不用自动变量，每个规则都要写全文件名，改一个目标名就要改好几处，多麻烦。

2.5 知识体系总览

下面这张图帮你理清Makefile的核心逻辑：

Makefile 核心知识体系 目标 (Target) 依赖 (Prerequisites) 规则 (Recipe) 真实目标（.elf, .o, .a） 伪目标（all, clean, install） 直接依赖（.c, .h） 间接依赖（被包含的头文件） 编译命令（gcc -c） 链接命令（gcc -o） 工作流程：检查依赖时间戳 → 决定是否重新编译 → 执行规则 核心原则：只有依赖比目标新时，才重新执行规则

2.6 常见陷阱与避坑指南

最后，分享几个我踩过的坑：

  • Tab vs 空格：Makefile里规则前面必须是Tab，不是空格。很多编辑器会自动把Tab转成空格，记得关掉这个功能。
  • 伪目标声明：如果目录下恰好有一个叫clean的文件，没有.PHONY: clean的话，make会认为clean已经是最新的，不会执行清理命令。
  • 依赖写全：头文件依赖一定要写全。我建议用gcc -MM自动生成依赖，后面章节会详细讲。
  • 变量赋值：=是递归展开，:=是简单展开。在嵌入式项目中，我习惯用:=，避免变量循环引用导致的问题。

我的习惯：每个Makefile开头我都会写一个all作为默认目标，最后写一个clean。这样不管是编译还是清理，一个make或make clean就搞定了。团队里其他人用起来也顺手。

好了，Makefile的基础知识就讲到这里。记住三个核心：目标、依赖、规则。下一节我们会深入Makefile的变量和函数，让你的构建脚本更加强大和灵活。

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

← 上一章 📖 返回目录 下一章 →