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</p>
注意：main.o 这行命令前必须是 Tab，不是 4 个空格——这是新手最常卡住的地方，错误信息不提示“你用了空格”，只报语法错误。
怎么自动处理多个 .cpp 文件的依赖
手写每个 .o 对应的规则太容易漏，也难维护。用 $(wildcard *.cpp) 收集源文件，再用 $(patsubst %.cpp,%.o,$(SRCS)) 批量转目标名，比硬编码靠谱得多。
关键点：
-
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 $</p><p>注意：<code>$^</code> 表示所有依赖，<code>$@</code> 是目标名，<code>$ 是第一个依赖——这些自动化变量少写一个就可能链接失败或编译跳过头文件搜索。</code></p><h3>调试 Makefile 时怎么看实际执行了什么命令</h3><p>加 <code>-n</code> 参数只打印命令不执行：<code>make -n</code>，能快速确认变量是否展开正确、路径有没有多斜杠、命令顺序对不对。</p><p>更进一步，加 <code>-d</code> 会输出完整决策过程（比如为什么某个目标被判定为过期），但信息量大，建议配合 <code>grep</code> 筛选：</p><pre class="brush:php;toolbar:false;">make -d 2>&1 | grep -E "(considering|must remake|recipe for)"
另外，$(info ...) 可以在任意位置打印变量值，比如 $(info OBJS = $(OBJS))，放在规则前就能看到变量展开结果，比靠猜可靠。
复杂项目里，隐式规则、变量覆盖、make 内置函数嵌套展开，会让行为和预期差很远。别急着改逻辑，先用 -n 看它到底打算干什么。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
