1、make构建应用教程

约 2192 字大约 7 分钟

2026-03-26

Make 是一个自动化构建工具，通过读取 Makefile 文件中的规则，自动判断哪些文件需要重新编译，并执行相应的命令。它是 C/C++ 项目中最常用的构建工具之一。

📚 一、Make 基础概念

1.1 Makefile 基本结构

# 注释以 # 开头
target: dependencies
	command

组成部分	说明
target	目标文件或动作名称（如 `myapp`、`clean`）
dependencies	依赖的文件列表，目标依赖这些文件
command	生成目标需要执行的命令（必须以 Tab 开头，不能用空格）

1.2 简单示例

# 编译可执行文件
myapp: main.o util.o
	gcc -o myapp main.o util.o

# 编译 main.o
main.o: main.c header.h
	gcc -c main.c

# 编译 util.o
util.o: util.c header.h
	gcc -c util.c

# 清理
clean:
	rm -f *.o myapp

执行效果：

$ make          # 构建 myapp（默认目标）
$ make clean    # 清理构建产物

🔧 二、Make 命令基本用法

2.1 命令格式

make [选项] [目标] [变量赋值]

2.2 常用命令

命令	说明
`make`	构建第一个目标（通常是 all）
`make target`	构建指定的目标
`make clean`	清理构建产物
`make -f file`	使用指定的 Makefile 文件
`make -n`	模拟执行（只打印命令，不实际执行）
`make -B`	强制重新构建所有目标
`make -j N`	并行构建（N 为并行任务数）
`make -k`	出错后继续构建其他目标

🎯 三、Make 命令选项详解

3.1 基本选项

选项	说明	示例
`-f file`	指定 Makefile 文件	`make -f MyMakefile`
`-C dir`	切换到指定目录执行	`make -C src`
`-I dir`	添加 include 搜索路径	`make -I config`
`-d`	显示调试信息	`make -d`
`-n`	模拟运行（dry-run）	`make -n install`
`-B`	强制重新构建（忽略时间戳）	`make -B`
`-k`	出错后继续	`make -k`
`-s`	静默模式（不显示命令）	`make -s`

3.2 并行构建选项

选项	说明	示例
`-j [N]`	并行执行 N 个任务	`make -j4`（4 个并行）
`-j`	无限并行	`make -j`
`-l load`	负载限制	`make -l 2.0`

性能对比：

# 单核构建
make clean && make          # 耗时：30秒

# 4核并行构建
make clean && make -j4      # 耗时：10秒

3.3 变量传递

方式	说明	示例
`VAR=value`	在命令行赋值	`make CC=clang`
`-e`	环境变量优先	`make -e`
`-E`	不覆盖环境变量	`make -E`

示例：

# 使用 clang 编译器
make CC=clang CFLAGS=-O3

# 传递多个变量
make DEBUG=1 OPTIMIZE=0

3.4 调试和帮助

选项	说明
`-p`	打印所有变量和规则
`-r`	禁止使用内置规则
`-R`	禁止使用内置变量
`-v`	显示 make 版本信息
`--help`	显示帮助信息

📝 四、Makefile 语法详解

4.1 变量

# 变量定义
CC = gcc
CFLAGS = -Wall -O2
SRCS = main.c util.c
OBJS = $(SRCS:.c=.o)          # 变量替换：将 .c 替换为 .o
TARGET = myapp

# 使用变量
$(TARGET): $(OBJS)
	$(CC) -o $@ $^

# 内置变量
$@    # 目标文件名
$^    # 所有依赖文件列表
$<    # 第一个依赖文件
$?    # 所有比目标新的依赖文件
$*    # 目标的主干名称（不含后缀）

变量赋值方式：

赋值符	说明	示例
`=`	递归展开（使用时才展开）	`CFLAGS = -Wall`
`:=`	简单展开（立即展开）	`SRCS := $(wildcard *.c)`
`?=`	条件赋值（未定义时才赋值）	`CC ?= gcc`
`+=`	追加值	`CFLAGS += -g`

4.2 自动变量

变量	说明	示例（目标 `myapp: main.o util.o`）
`$@`	目标文件名	`myapp`
`$<`	第一个依赖文件	`main.o`
`$^`	所有依赖文件列表	`main.o util.o`
`$?`	所有比目标新的依赖文件	`main.o`（如果 main.o 比 myapp 新）
`$*`	目标的主干名称	`myapp`（不含后缀）

4.3 通配符和函数

# 通配符
SRCS = $(wildcard src/*.c)           # 匹配所有 .c 文件
OBJS = $(patsubst %.c, %.o, $(SRCS)) # 模式替换

# 常用函数
$(shell command)                     # 执行 shell 命令
$(notdir file)                       # 去除路径
$(dir file)                          # 提取目录
$(basename file)                     # 去除后缀
$(suffix file)                       # 提取后缀
$(subst from,to,text)                # 字符串替换
$(filter pattern, text)              # 过滤
$(sort list)                         # 排序去重

4.4 条件判断

# ifeq/ifneq
ifeq ($(DEBUG), 1)
    CFLAGS += -g -DDEBUG
else
    CFLAGS += -O2
endif

# ifdef/ifndef
ifdef BOOST_ROOT
    CFLAGS += -I$(BOOST_ROOT)/include
endif

4.5 循环和模式规则

# 模式规则
%.o: %.c
	$(CC) $(CFLAGS) -c $< -o $@

# 静态模式规则
$(OBJS): %.o: %.c
	$(CC) $(CFLAGS) -c $< -o $@

# foreach 循环
DIRS = src test lib
all:
	@for dir in $(DIRS); do \
		$(MAKE) -C $$dir; \
	done

🏗️ 五、实战示例

5.1 基础 C 项目

目录结构：

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

Makefile：

# 编译器设置
CC = gcc
CFLAGS = -Wall -O2 -Iinclude
LDFLAGS = -lm

# 源文件和目标文件
SRCS = $(wildcard src/*.c)
OBJS = $(SRCS:src/%.c=obj/%.o)
DEPS = $(OBJS:.o=.d)
TARGET = bin/myapp

# 创建目录
$(shell mkdir -p obj bin)

# 默认目标
all: $(TARGET)

# 链接
$(TARGET): $(OBJS)
	$(CC) $^ -o $@ $(LDFLAGS)

# 编译（自动生成依赖）
obj/%.o: src/%.c
	$(CC) $(CFLAGS) -MMD -MP -c $< -o $@ -MF $(@:.o=.d)

# 清理
clean:
	rm -rf obj bin

# 安装
install: $(TARGET)
	cp $(TARGET) /usr/local/bin/

# 运行
run: $(TARGET)
	./$(TARGET)

# 帮助
help:
	@echo "Available targets:"
	@echo "  all      - Build the project"
	@echo "  clean    - Remove build artifacts"
	@echo "  install  - Install to /usr/local/bin"
	@echo "  run      - Build and run"
	@echo "  help     - Show this help"

# 包含依赖文件
-include $(DEPS)

.PHONY: all clean install run help

使用：

$ make          # 构建
$ make run      # 构建并运行
$ make clean    # 清理
$ make install  # 安装（需要 sudo）

5.2 多目录项目

# 项目根目录 Makefile
PROJECTS = lib src test

all:
	@for dir in $(PROJECTS); do \
		$(MAKE) -C $$dir; \
	done

clean:
	@for dir in $(PROJECTS); do \
		$(MAKE) -C $$dir clean; \
	done

.PHONY: all clean

子目录 Makefile (src/Makefile)：

# 子目录 Makefile
CC = gcc
CFLAGS = -Wall -I../include
SRCS = $(wildcard *.c)
OBJS = $(SRCS:.c=.o)
TARGET = ../bin/myapp

all: $(TARGET)

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

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

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

.PHONY: all clean

5.3 调试和发布配置

# 调试模式（默认）
ifeq ($(BUILD), release)
    CFLAGS = -Wall -O2 -DNDEBUG
    TARGET = bin/myapp_release
else
    CFLAGS = -Wall -g -O0 -DDEBUG
    TARGET = bin/myapp_debug
endif

CC = gcc
SRCS = $(wildcard src/*.c)
OBJS = $(SRCS:src/%.c=obj/%.o)

all: $(TARGET)

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

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

clean:
	rm -rf obj bin

.PHONY: all clean

使用：

$ make               # 调试版本
$ make BUILD=release # 发布版本

🔍 六、Make 命令高级技巧

6.1 并行构建

# 使用所有 CPU 核心
make -j$(nproc)

# 限制并行数
make -j4

# 查看构建时间
time make -j8

6.2 调试技巧

# 打印执行的命令
make -n

# 打印变量值
make -p | grep VARIABLE

# 详细调试
make -d

# 打印依赖树
make -p | less

6.3 条件构建

# 只编译修改的文件
make

# 强制重新编译所有
make -B

# 忽略错误继续
make -k

6.4 递归调用

# 递归调用 make
subsystem:
	cd subdir && $(MAKE)

# 或者
subsystem:
	$(MAKE) -C subdir

# 传递变量
export CFLAGS = -Wall
subsystem:
	$(MAKE) -C subdir

📊 七、常见目标和约定

目标	说明	示例
`all`	默认目标，构建所有	`make all`
`clean`	清理构建产物	`make clean`
`distclean`	深度清理（包括配置文件）	`make distclean`
`install`	安装到系统	`make install`
`uninstall`	卸载	`make uninstall`
`test` / `check`	运行测试	`make test`
`depend`	生成依赖关系	`make depend`
`dist` / `package`	打包源码	`make dist`
`help`	显示帮助信息	`make help`

⚙️ 八、Makefile 最佳实践

8.1 推荐模板

# ============================================================================
# Makefile 模板
# ============================================================================

# 可配置变量
CC ?= gcc
CXX ?= g++
CFLAGS ?= -Wall -O2
CXXFLAGS ?= -Wall -O2
LDFLAGS ?=

# 项目配置
PROJECT_NAME = myapp
VERSION = 1.0.0

# 目录结构
SRC_DIR = src
INC_DIR = include
OBJ_DIR = obj
BIN_DIR = bin
LIB_DIR = lib

# 源文件
SRCS = $(wildcard $(SRC_DIR)/*.c)
OBJS = $(SRCS:$(SRC_DIR)/%.c=$(OBJ_DIR)/%.o)
DEPS = $(OBJS:.o=.d)

# 目标
TARGET = $(BIN_DIR)/$(PROJECT_NAME)

# 创建目录
$(shell mkdir -p $(OBJ_DIR) $(BIN_DIR))

# 默认目标
all: $(TARGET)

# 链接
$(TARGET): $(OBJS)
	$(CC) $^ -o $@ $(LDFLAGS)

# 编译
$(OBJ_DIR)/%.o: $(SRC_DIR)/%.c
	$(CC) $(CFLAGS) -I$(INC_DIR) -MMD -MP -c $< -o $@ -MF $(@:.o=.d)

# 清理
clean:
	rm -rf $(OBJ_DIR) $(BIN_DIR)

# 深度清理
distclean: clean
	rm -f Makefile.dep

# 依赖生成
depend:
	$(CC) -MM $(CFLAGS) -I$(INC_DIR) $(SRCS) > Makefile.dep

# 安装
install: $(TARGET)
	install -d $(DESTDIR)/usr/local/bin
	install -m 755 $(TARGET) $(DESTDIR)/usr/local/bin

# 卸载
uninstall:
	rm -f $(DESTDIR)/usr/local/bin/$(PROJECT_NAME)

# 帮助
help:
	@echo "Usage: make [target]"
	@echo ""
	@echo "Targets:"
	@echo "  all      - Build the project (default)"
	@echo "  clean    - Remove build artifacts"
	@echo "  distclean- Remove all generated files"
	@echo "  install  - Install the project"
	@echo "  uninstall- Uninstall the project"
	@echo "  help     - Show this help"

# 伪目标
.PHONY: all clean distclean install uninstall help depend

# 包含依赖文件
-include $(DEPS)
-include Makefile.dep

8.2 常见陷阱和解决方案

问题	解决方案
命令前使用空格而非 Tab	确保命令前是 Tab，不是空格
依赖关系不完整	使用 `-MMD` 自动生成依赖
头文件修改未触发重编译	在编译时生成 `.d` 文件并 include
并行构建时目录创建问题	使用 `
变量未传递到子 make	使用 `export` 或在命令行传递

📚 九、快速参考

9.1 常用命令速查

命令	说明
`make`	构建默认目标
`make clean`	清理
`make -j4`	4 核并行构建
`make -n`	查看将执行的命令
`make -B`	强制重新构建
`make -C dir`	切换到目录构建
`make VAR=value`	传递变量
`make -p \| less`	查看所有规则

9.2 变量速查

变量	说明
`$@`	目标文件名
`$<`	第一个依赖
`$^`	所有依赖
`$?`	更新的依赖
`$*`	目标主干名

💡 核心要点：Make 的核心是依赖关系和时间戳比较。合理使用自动变量、模式规则和并行构建可以显著提升构建效率。对于大型项目，建议结合 -MMD 自动生成依赖，避免手动维护。

贡献者

codingLab

cmake

mpc

make

1、make构建应用教程

📚 一、Make 基础概念

1.1 Makefile 基本结构

1.2 简单示例

🔧 二、Make 命令基本用法

2.1 命令格式

2.2 常用命令

🎯 三、Make 命令选项详解

3.1 基本选项

3.2 并行构建选项

3.3 变量传递

3.4 调试和帮助

📝 四、Makefile 语法详解

4.1 变量

4.2 自动变量

4.3 通配符和函数

4.4 条件判断

4.5 循环和模式规则

🏗️ 五、实战示例

5.1 基础 C 项目

5.2 多目录项目

5.3 调试和发布配置

🔍 六、Make 命令高级技巧

6.1 并行构建

6.2 调试技巧

6.3 条件构建

6.4 递归调用

📊 七、常见目标和约定

⚙️ 八、Makefile 最佳实践

8.1 推荐模板

8.2 常见陷阱和解决方案

📚 九、快速参考

9.1 常用命令速查

9.2 变量速查

贡献者

1、make构建应用教程

详情