Linux学习笔记——例说makefile 头文件查找路径

0.前言

从学习C语言开始就慢慢开始接触makefile，查阅了很多的makefile的资料但总感觉没有真正掌握makefile，如果自己动手写一个makefile总觉得非常吃力。所以特意借助博客总结makefile的相关知识，通过例子说明makefile的具体用法。

例说makefile分为以下几个部分，更多内容请参考【例说makefile索引博文】

1.只有单个C文件
2.含有多个C文件
3.需要包括头文件路径

4.增加宏定义
5.增加系统共享库
6.增加自定义共享库
7.一个实际的例子

【代码仓库】——makefile-example
代码仓库位于bitbucket，可借助TortoiseHg（GUI工具）克隆代码或者在网页中直接下载zip包。

1.三个C文件和三个头文件
此处的例子稍微复杂些但更接近实际情况。
文件结果如下：根目录中包含test.c makefileh和文件夹test-add和文件夹test-sub。
test.c makefile
【test-add】test-add.c test-add.h
【test-sub】test-sub.c test-sub.h

【test.c】

#include <stdio.h>
#include <test-add.h>
#include <test-sub.h>
int main(void)
{
    int a = 3;
    int b = 2;
       
    printf("a=%d\n", a);
    printf("b=%d\n", b);
 
    printf("a+b=%d\n", add(a,b));
    printf("a-b=%d\n", sub(a,b));
    return 0;
}

【test-add.c】

#include <test-add.h>
int add(int a, int b)
{
    return a+b;
}

【test-add.h】

#ifndef __TEST_ADD
int add(int a, int b);
#endif

【test-sub.c】

#include "test-sub.h"
int sub(int a, int b)
{
    return a-b;
}

【test-sub.h】

#ifndef __TEST_SUB
int sub(int a, int b);
#endif

2.复习gcc指令
gcc指令可通过-I前缀指定头文件路径，特别说明./代表当前路径，../代表上一级目录。

3.编写makefile
请替换其中的[tab]，并以代码仓库中的makefile文件为主。

# 指令编译器和选项
CC=gcc
CFLAGS=-Wall -std=gnu99

# 目标文件
TARGET=test
SRCS = test.c \
  ./test-add/test-add.c \
  ./test-sub/test-sub.c

INC = -I./test-add -I./test-sub

OBJS = $(SRCS:.c=.o)

$(TARGET):$(OBJS)
#	@echo TARGET:$@
#	@echo OBJECTS:$^
[tab]$(CC) -o $@ $^

clean:
[tab]rm -rf $(TARGET) $(OBJS)

%.o:%.c
[tab]$(CC) $(CFLAGS) $(INC) -o $@ -c $<

【具体说明】
【1】相比于单个文件和多个文件的makefile，通过变量INC制定了头文件路径。头文件路径之间通过空格隔开。
【2】编译规则%.o:%.c中加入了头文件参数$(CC) $(CFLAGS) $(INC) -o $@ -c $<，那么在编译的过程中便会出现
gcc -Wall -std=gnu99 -I./test-add -I./test-sub -o test.o -c test.c。和单个文件和多个文件的makefile相比增加了头文件路径参数。
【3】SRCS变量中，文件较多时可通过“\”符号续行。

【编译】
make clean && make
【控制台输出】
rm -rf test test.o ./test-add/test-add.o ./test-sub/test-sub.o
gcc -Wall -std=gnu99 -I./test-add -I./test-sub -o test.o -c test.c
gcc -Wall -std=gnu99 -I./test-add -I./test-sub -o test-add/test-add.o -c test-add/test-add.c
gcc -Wall -std=gnu99 -I./test-add -I./test-sub -o test-sub/test-sub.o -c test-sub/test-sub.c
gcc -o test test.o test-add/test-add.o test-sub/test-sub.o
从控制台的输出可以看出，通过make clean清除上一次的可执行文件和目标文件，然后依次编译各个C文件，在编译的过程中制定了头文件路径，最后把3个目标文件链接为最终可执行文件。