【Linux】Makefile编写——详细教程

target: dependencies   # 目标: 依赖
    command            # 命令（必须用Tab缩进）
目标(Target)：要生成的文件或操作名称

依赖(Dependencies)：目标所需的文件或其他目标

命令(Commands)：生成目标的Shell指令

2. 工作流程示意图

[make命令]
    ↓
查找Makefile → 定位第一个目标
    ↓
检查依赖是否更新 → 执行关联命令
    ↓
生成最终目标

二、Makefile基础实战

1. 最小化示例

// myproc.c
#include <stdio.h>
int main() {
    printf("Hello Makefile!\n");
    return 0;
}


# Makefile
myproc: myproc.c      # 目标:依赖
    gcc -o myproc myproc.c  # 编译命令

.PHONY: clean        # 声明伪目标
clean:
    rm -f myproc     # 清理命令
操作演示：

$ make       # 编译程序
$ ./myproc   # 运行输出 Hello Makefile!
$ make clean # 清理生成的文件

三、核心机制深度解析

1. 依赖关系与时间戳

Makefile的核心机制是基于文件修改时间的依赖检查：

$ stat myproc.c  # 查看文件状态
  Modify: 2024-10-25 17:05:25.940595116 +0800  # 内容修改时间
  Change: 2024-10-25 17:05:25.940595116 +0800  # 属性修改时间
当目标文件比依赖文件旧时，执行命令重新构建

使用touch命令可测试此机制：

$ touch myproc.c   # 更新文件时间戳
$ make             # 触发重新编译

2. 伪目标(.PHONY)的特殊性

.PHONY: clean

总是执行命令（忽略文件存在性和时间戳）
常用伪目标：clean install test等
避免与同名文件冲突

四、多文件编译实战

1. 项目结构

project/
├── main.c
├── utils.c
├── utils.h
└── Makefile

2. Makefile实现

# 定义目标可执行文件
TARGET = app

# 定义编译器和选项
CC = gcc
CFLAGS = -Wall -O2

# 获取所有.c文件并转换为.o文件
SRCS = $(wildcard *.c)
OBJS = $(SRCS:.c=.o)

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

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

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

关键语法解析：

wildcard：获取匹配模式的文件列表

$(SRCS:.c=.o)：字符串替换，将.c替换为.o

$@：当前目标名

$^：所有依赖文件

$<：第一个依赖文件

五、Makefile高级技巧

1. 变量进阶用法

# 定义安装路径
PREFIX ?= /usr/local
BINDIR = $(PREFIX)/bin

# 条件判断
DEBUG ?= 0
ifeq ($(DEBUG),1)
    CFLAGS += -g -DDEBUG
endif

install: $(TARGET)
    install -m 755 $< $(BINDIR)

2. 自动化头文件依赖

DEPDIR = .deps
DEPFLAGS = -MT $@ -MMD -MP -MF $(DEPDIR)/$*.d

COMPILE.c = $(CC) $(DEPFLAGS) $(CFLAGS) -c

%.o: %.c $(DEPDIR)/%.d | $(DEPDIR)
    $(COMPILE.c) $<

$(DEPDIR):
    @mkdir -p $@

DEPFILES = $(SRCS:%.c=$(DEPDIR)/%.d)
include $(wildcard $(DEPFILES))

3. 多目录项目管理

project/
├── src/
│   ├── main.c
│   └── utils.c
├── include/
│   └── utils.h
└── Makefile


SRCDIR = src
INCDIR = include
BUILDDIR = build

SRCS = $(wildcard $(SRCDIR)/*.c)
OBJS = $(patsubst $(SRCDIR)/%.c,$(BUILDDIR)/%.o,$(SRCS))

$(BUILDDIR)/%.o: $(SRCDIR)/%.c
    @mkdir -p $(@D)
    $(CC) $(CFLAGS) -I$(INCDIR) -c $< -o $@

六、Makefile调试技巧

1. 调试命令
make -n      # 干运行（显示但不执行命令）
make --debug # 显示详细调试信息
make -p      # 打印所有规则和变量
2. 打印变量值
print-%:
    @echo '$* = $($*)'
    
# 使用示例
$ make print-CC
CC = gcc
3. 错误处理
# 忽略命令错误
clean:
    -rm -f *.o   # 前面加"-"忽略错误

# 错误退出处理
install:
    [ -d $(BINDIR) ] || mkdir -p $(BINDIR)
    install ...

七、工程最佳实践

1. 推荐目录结构

project/
├── src/      # 源代码
├── include/  # 头文件
├── lib/      # 第三方库
├── build/    # 构建输出
├── tests/    # 测试代码
└── Makefile  # 构建入口

2. 通用Makefile模板

# 基础配置
TARGET   = app
CC       = gcc
CFLAGS   = -Wall -O2 -Iinclude
LDFLAGS  = -Llib -lmylib
BUILDDIR = build

# 自动收集源文件
SRCS = $(shell find src -name '*.c')
OBJS = $(patsubst src/%.c,$(BUILDDIR)/%.o,$(SRCS))

# 主构建规则
$(BUILDDIR)/$(TARGET): $(OBJS)
    $(CC) $^ -o $@ $(LDFLAGS)

# 模式规则
$(BUILDDIR)/%.o: src/%.c
    @mkdir -p $(@D)
    $(CC) $(CFLAGS) -c $< -o $@

# 伪目标
.PHONY: all clean install

all: $(BUILDDIR)/$(TARGET)

clean:
    rm -rf $(BUILDDIR)

install: all
    install -m 755 $(BUILDDIR)/$(TARGET) /usr/local/bin