基于头文件依赖与多重包含，如何为给定C源码编写Makefile？

现有C源文件与头文件 #

a.h #

//a.h
#ifndef A_H
#define A_H
#include <stdio.h> 
int fun(int i);
#endif

a.c #

//a.c
#include "a.h"
int fun(int i){
    if(i%2==0){
        return 1;
    }
    printf("%d\n",i);                                                          
}

b.h #

//b.h
#ifndef B_H
#define B_H
#include "a.h"
int fun2(int i);
#endif

b.c #

//b.c
#include "b.h"
#include <stdio.h>
int fun2(int i){
    if(i%2==0){
        return 1;
    }
    printf("%d\n",fun(2));
}                                                                           

c.c #

//c.c
#include "b.h"
#include <stdio.h>
int main(){
    int a=1;
    a=fun(1);
    printf("%d %d\n",a,fun(1));
    int b=1;
    b=fun2(2);
    printf("%d %d\n",b,fun2(1));
}

现有Makefile的问题 #

你当前的Makefile存在两处关键错误：

1. 编译b.o时使用cc -c b.c a.o是错误的：-c参数指定只编译不链接，编译阶段不需要引入其他.o文件，这会导致编译报错。
2. 生成main时仅链接了c.c和b.o，但c.c调用了fun()（定义在a.o中），缺少a.o会导致链接阶段找不到函数定义；同时没有生成c.o，不符合“生成所有.c对应.o文件”的需求。

修正后的Makefile #

CC = gcc
CFLAGS = -Wall -Wextra  # 可选参数，开启编译警告帮助排查代码问题

# 最终目标：生成main可执行文件
all: main

# 链接所有.o文件生成main
main: c.o b.o a.o
	$(CC) $^ -o $@

# 编译c.c生成c.o，依赖b.h（c.c包含b.h）
c.o: c.c b.h
	$(CC) $(CFLAGS) -c $< -o $@

# 编译b.c生成b.o，依赖b.h和a.h（b.c包含b.h，b.h包含a.h）
b.o: b.c b.h a.h
	$(CC) $(CFLAGS) -c $< -o $@

# 编译a.c生成a.o，依赖a.h
a.o: a.c a.h
	$(CC) $(CFLAGS) -c $< -o $@

# 清理生成的目标文件和可执行文件
.PHONY: clean
clean:
	rm -rf *.o main

修正说明 #

1. 编译与链接分离：每个.c文件单独编译生成对应的.o文件，仅在生成main时进行链接操作，符合编译流程规范。
2. 完整依赖声明：每个.o文件都明确标注依赖的头文件，当头文件内容修改时，Make会自动重新编译对应的.o文件，避免因依赖更新不及时导致的错误。
3. 全依赖链接：生成main时将所有需要的.o文件（c.o、b.o、a.o）都加入链接，确保所有函数定义都能被正确找到。
4. 自动变量简化：使用$^（所有依赖文件）、$<（第一个依赖文件）、$@（目标文件）等自动变量，让Makefile更简洁易维护。

内容的提问来源于stack exchange，提问作者Fitohe