目标

以适合在makefile中使用的形式，自动根据代码列出文件间的依赖关系。

背景

make在编译程序时，根据时间戳决定哪些需要重新编译哪些不需要。为了做到这一点，make需要知道源文件、中间文件和可执行文件之间的依赖关系。这些信息由makefile以规则的形式提供。例如：

main.o: main.c foo.h bar.h

main.o依赖main.c foo.h bar.h 手动创建这些规则既繁琐又容易出错。一旦出错可能很难诊断，因为这可能会导致编译得到的程序与源代码不一致。处于这些原因，除了简单的程序之外，所有程序都非常希望使用自动机制来识别依赖关系。

场景

假设你有个makefile，用来编译同一个目录下的所有扩展名为.c的文件，并且链接生成名字为hello_world的可执行程序：

SRC = $(wildcard *.c)
hello_world: $(SRC:%c=%o)
    $(LD) -o $@ $^

目录中任何一个.c文件发生更改时，都能正确地构建可执行程序，但是，如果.c文件中包含的.h文件发生改变时，则不会正确地重新构建。
您希望纠正此缺陷，但不想明确指定源文件中依赖的头文件。假设您正在使用GCC和GNU Make。

方法

GCC可以在编译程序时创建依赖项列表，可以使用如下选项方法：

• 如果您想包含系统头文件，使用-MD选项
• 如果您不想包含系统头文件，使用-MMD选项

包含系统头文件时更健壮的选择，但是，系统头文件通常很少更改，并且会大大增加依赖项的数量。

默认情况下，生成的依赖项会被写入到一个扩展名.d的文件中，并且符合makefile的格式，您需要做的工作是：

• 将-MD添加到通过make传递给编译器的选项列表中
• 通过include指令将依赖文件合并到makefile中

一个有用的选项是-MP，它为生成的每个依赖创建一条空规则，这样能抑制删除或重命名头文件时发生的错误。
因为-MD和-MP是预处理选项，在makefile中设定他们的方法是将他们加到CPPFLAGS：

CPPFLAGS += -MD -MP

include指令必须列出依赖的文件。大多数makefile已经有源文件或目标文件的列表，可以通过替换从中获得依赖文件的名称，在这个示例中，可以使用包含了所有源文件的SRC变量：

-include $(SRC:%.c=%.d)

include指令前的字符-存在的目的是避免在依赖文件不存在时输出错误消息。

include指令不能位于默认目标之前，否则include的第一条规则将成为默认目标。防止这种情况发生的一种简单方法是将include放到makefile的末尾。

不要添加显式创建依赖文件的规则。这里介绍的方法将在需要时构建或重建这些依赖文件。显式创建依赖文件的规则只会让make去做一些不必要的工作。这种方式是微妙但有效的。

• 如果依赖文件需要更新，则相应的目标文件也需要更新
• 要更新目标文件只需要更新相应的依赖文件
• 因此，如果在必要的时候更新目标文件，则依赖文件也会更新。

下面是这种场景对应的完整的makefile

CPPFLAGS += -MD -MP

SRC = $(wildcard *.c)

hello_world: $(SRC:%.c=%.o)
	$(LD) -o $@ $^

-include $(SRC:%.c=%.d)

备选方案

使用set和-M选项。 GNU Make手册建议使用正则表达式显式创建依赖文件

%.d: %.c
	@set -e; rm -f $@; \
	$(CC) -M $(CPPFLAGS) lt; > $@.$$; \
	sed 's,\($*\)\.o[ :]*,\1.o $@ : ,g' < $@.$$ > $@; \
	rm -f $@.$$

这具有使用-M选项代替-MD的优点，使用-M选项得到了GCC以外编译器的广泛支持，但缺点是：

• 源代码必须被预处理2次（第一次创建依赖文件，第二次编译目标代码）
• 此方法无法正常处理已删除或已重命名的依赖项（相关的依赖项文件必须手动删除）。

使用GNU Automake

Automake是自动生成符合GNU Coding标准的、可移植makefile的工具。它通常与autoconf和Libtool配合使用，如果可以，它通过编译器生成依赖项；如果不可以，它通过makedepend生成依赖项。

特别声明：本文为 Automatically generate makefile dependencies [http://www.microhowto.info/howto/automatically_generate_makefile_dependencies.html] 的译文，由 雨风 翻译，欢迎转载，转载请保留本特别声明，谢谢。