Makefile最小结构为三行：CC=g++、target:依赖；命令行必须用Tab缩进。自动处理多文件依赖需用wildcard和patsubst生成OBJS，加-MMD和-include实现头文件自动依赖；CPPFLAGS/LDFLAGS须显式写入命令中，配合$@、$^等自动化变量及$(info)调试更可靠。
Makefile 最小可用结构长什么样
一个能编译单个 main.cpp 的 Makefile，核心就三行：CC 指定编译器，target 定义输出，依赖和命令写在同一行且以制表符开头。别用空格缩进，否则 make 直接报错 *** missing separator。
示例：
CC = g++
main: main.o
$(CC) -o main main.o
<p>main.o: main.cpp
$(CC) -c main.cpp注意：main.o 这行命令前必须是 Tab，不是 4 个空格——这是新手最常卡住的地方，错误信息不提示“你用了空格”，只报语法错误。
怎么自动处理多个 .cpp 文件的依赖
手写每个 .o 对应的规则太容易漏，也难维护。用 $(wildcard *.cpp) 收集源文件，再用 $(patsubst %.cpp,%.o,$(SRCS)) 批量转目标名，比硬编码靠谱得多。
立即学习“C++免费学习笔记（深入）”；
关键点：
-
SRCS := $(wildcard *.cpp)—— 注意用:=而非=，避免重复展开 -
OBJS := $(SRCS:.cpp=.o)—— 更简洁的后缀替换写法，等价于patsubst - 加一句
-include $(OBJS:.o=.d)，再在编译命令里加-MMD，就能自动生成头文件依赖（比如main.d），后续改了utils.h，make会自动重编依赖它的.o
为什么加了 -I 或 -L 还是找不到头文件或库
路径拼写错误只是表象，真正常见原因是：变量没传进命令行。Makefile 里定义的 CPPFLAGS 和 LDFLAGS 不会自动生效，得显式用在对应命令中。
正确写法：
CPPFLAGS = -I./include -I/usr/local/include LDFLAGS = -L./lib -ljsoncpp <p>main: $(OBJS) $(CC) $(LDFLAGS) -o $@ $^</p><p>%.o: %.cpp $(CC) $(CPPFLAGS) -c $< -o $@
注意：$^ 表示所有依赖，$@ 是目标名，$ 是第一个依赖——这些自动化变量少写一个就可能链接失败或编译跳过头文件搜索。
调试 Makefile 时怎么看实际执行了什么命令
加 -n 参数只打印命令不执行：make -n，能快速确认变量是否展开正确、路径有没有多斜杠、命令顺序对不对。
更进一步，加 -d 会输出完整决策过程（比如为什么某个目标被判定为过期），但信息量大，建议配合 grep 筛选：
make -d 2>&1 | grep -E "(considering|must remake|recipe for)"
另外，$(info ...) 可以在任意位置打印变量值，比如 $(info OBJS = $(OBJS))，放在规则前就能看到变量展开结果，比靠猜可靠。
复杂项目里，隐式规则、变量覆盖、make 内置函数嵌套展开，会让行为和预期差很远。别急着改逻辑，先用 -n 看它到底打算干什么。
