Makefile 中文教程

一、什么是 Makefile？

Makefile 是一个自动化构建工具的配置文件，用于管理项目中的编译、链接、安装等任务。它通过定义依赖关系和执行命令，实现：

• 只重新编译修改过的文件
• 简化复杂的构建命令
• 实现多平台兼容构建

二、基本语法

目标: 依赖文件
[Tab]命令1
[Tab]命令2

示例：

# 编译 main.c 生成可执行文件 app
app: main.c
    gcc main.c -o app

三、核心概念

1. 目标 (Target)
   要生成的文件名（如 app）或操作名（如 clean）

2. 依赖 (Dependencies)
   生成目标所需的文件列表（如 .c 文件）

3. 命令 (Commands)
   以 Tab 开头，执行操作的 Shell 命令

四、变量使用

# 定义变量
CC = gcc
CFLAGS = -Wall -O2

app: main.c
    $(CC) $(CFLAGS) main.c -o app

五、自动变量（常用）

示例：

app: main.c utils.c
    gcc $^ -o $@

六、模式规则（通配符）

# 编译所有 .c 文件生成 .o 文件
%.o: %.c
    gcc -c $< -o $@

七、伪目标

声明不生成实际文件的操作（如 clean）：

.PHONY: clean
clean:
    rm -f *.o app

八、函数使用

常用内置函数：

# 获取所有 .c 文件
SRCS = $(wildcard *.c)

# 将 .c 替换为 .o
OBJS = $(patsubst %.c, %.o, $(SRCS))

九、完整示例

CC = gcc
CFLAGS = -Wall
SRCS = main.c utils.c
OBJS = $(patsubst %.c, %.o, $(SRCS))
TARGET = app

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

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

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

十、使用流程

1. 编写 Makefile
2. 终端执行：

   make        # 默认构建第一个目标
   make clean  # 执行清理操作

十一、高级技巧

1. 条件判断：

   ifeq ($(OS),Windows_NT)
    RM = del /Q
   else
    RM = rm -f
   endif

2. 包含其他 Makefile：

   include config.mk

3. 静默执行：

   @echo "正在编译..."  # @ 隐藏命令回显

十二、常见错误解决

1. Missing separator：命令前缺少 Tab 键
2. No rule to make target：依赖文件不存在
3. Command not found：命令拼写错误或未安装工具

推荐工具：make -d 查看详细调试信息

通过本教程，您已掌握 Makefile 的核心用法。实际项目中可结合自动化工具（如 CMake）生成更复杂的 Makefile。