# --------------------------------------------------- # 1. 变量定义 # --------------------------------------------------- # 目标文件列表 objs := main.o sub.o # 依赖文件列表 (先假定名称，用于生成 wildcard 搜索列表) dep_files_list := $(patsubst %.o, .%.o.d, $(objs)) # 实际存在的依赖文件 (用于 include) # 注意：使用 new_dep_files 避免覆盖原 dep_files_list new_dep_files := $(wildcard $(dep_files_list)) # --------------------------------------------------- # 2. 默认目标 (链接) # --------------------------------------------------- test : $(objs) gcc -o test $^ # --------------------------------------------------- # 3. 模式规则 (编译与依赖生成) # --------------------------------------------------- # 修正了 -Wp,-MD 错误，使用更规范的 -MD -MF 格式 %.o : %.c gcc -c -o $@ $< -MD -MF .$@.d # --------------------------------------------------- # 4. 依赖文件包含 (核心) # --------------------------------------------------- ifneq ($(new_dep_files),) include $(new_dep_files) endif # --------------------------------------------------- # 5. 清理目标 # --------------------------------------------------- .PHONY: clean distclean clean: # 仅删除目标文件和可执行文件 rm -f test $(objs) distclean: # 删除所有编译结果和依赖文件 (更彻底的清理) rm -f test $(objs) $(actual_dep_files)这是一个非常高质量的Makefile模板，它实现了自动依赖追踪和模块化编译。下面我将逐行详细解释。
💻 Makefile 逐行详解
1. 变量定义部分
| 行号 | 代码 | 解释 |
|---|---|---|
| 1-3 | # ----------------... | 注释行，用于组织Makefile结构。 |
| 4 | objs := main.o sub.o | 定义目标文件列表。使用即时变量:=定义了最终链接所需的.o文件。 |
| 5-6 | # 依赖文件列表... | 注释行。 |
| 7 | dep_files_list := $(patsubst %.o, .%.o.d, $(objs)) | 生成依赖文件名称列表。使用patsubst函数对$(objs)列表中的每一个元素进行模式替换：将所有的.o替换为.o.d，并在前面加一个点（.）。结果：dep_files_list的值为.main.o.d .sub.o.d。 |
| 8-9 | # 实际存在的... | 注释行。 |
| 10 | new_dep_files := $(wildcard $(dep_files_list)) | 查找已存在的依赖文件。使用wildcard函数在文件系统中搜索dep_files_list中列出的所有文件。目的：确保只include那些已经被gcc实际生成的.d文件，避免make在第一次运行时因为文件不存在而报错。 |
2. 默认目标（链接）
| 行号 | 代码 | 解释 |
|---|---|---|
| 13 | test : $(objs) | 目标和依赖。定义最终目标test，它依赖于变量$(objs)中的所有.o文件（即main.o和sub.o）。 |
| 14 | gcc -o test $^ | 链接命令。使用gcc将所有依赖文件（$^代表所有依赖，即main.o sub.o）链接成名为test的可执行文件。 |
3. 模式规则（编译与依赖生成）—核心
| 行号 | 代码 | 解释 |
|---|---|---|
| 17 | %.o : %.c | 模式规则。定义了如何从任何一个.c文件（如main.c）生成对应的.o文件（如main.o）。 |
| 18 | gcc -c -o $@ $< -MD -MF .$@.d | 编译命令。这是实现自动依赖追踪的关键命令： *gcc -c -o $@ $<：正常的编译命令。$@是目标文件（如main.o），$<是第一个依赖文件（如main.c）。 *-MD：指示 GCC在编译的同时生成依赖关系列表。 *-MF .$@.d：指示 GCC 将生成的依赖关系列表写入到指定的文件中。.$@.d展开后是.main.o.d或.sub.o.d。 |
4. 依赖文件包含（核心）
| 行号 | 代码 | 解释 |
|---|---|---|
| 22 | ifneq ($(new_dep_files),) | 条件判断。检查变量$(new_dep_files)是否不为空。只有当至少有一个.d文件存在时，才执行包含操作。 |
| 23 | include $(new_dep_files) | 包含依赖。如果.d文件存在，make会将这些.d文件的内容读入并作为Makefile的一部分来处理。这些文件包含了诸如main.o: main.c sub.h这样的规则。 |
| 24 | endif | 结束条件判断。 |
5. 清理目标
| 行号 | 代码 | 解释 |
|---|---|---|
| 27 | .PHONY: clean distclean | 伪目标声明。声明clean和distclean不是实际文件名，而是动作，确保它们能够可靠执行。 |
| 30 | clean: | 目标。删除编译结果（.o和test可执行文件）。 |
| 31 | rm -f test $(objs) | 命令。仅删除可执行文件test和所有目标文件$(objs)。 |
| 33 | distclean: | 目标。更彻底的清理。 |
| 34 | rm -f test $(objs) $(actual_dep_files) | 命令。删除所有编译结果（test和.o文件）以及自动生成的依赖文件（.d文件）。 |
