最小可用Makefile仅需三行：目标、依赖、命令，如app: main.o；main.o: main.cpp；g++ -c main.cpp，且缩进必须用Tab而非空格。
Makefile 最小可用结构长什么样
一个能跑起来的 C++ Makefile，核心就三行：目标、依赖、命令。没有花哨语法也能编译单个源文件。
比如项目只有一个 main.cpp，想生成可执行文件 app，直接写：
app: main.o
g++ -o app main.o
main.o: main.cpp
g++ -c main.cpp
注意缩进必须是 Tab 字符，不能用空格——这是 GNU Make 的硬性要求，否则报错 Makefile:2: *** missing separator. Stop.
常见误区是复制粘贴时把 Tab 变成空格，编辑器要设为显示不可见字符来确认。
立即学习“C++免费学习笔记（深入）”；
怎么自动处理多个 .cpp 文件和头文件依赖
手写每个 .o 规则太累，而且改了头文件不会自动重编——g++ -M 是解法。
用变量和模式规则让 Makefile 可扩展：
CC = g++ CFLAGS = -std=c++17 -Wall -I./include SRCS = $(wildcard src/*.cpp) OBJS = $(SRCS:.cpp=.o) DEPS = $(SRCS:.cpp=.d)app: $(OBJS) $(CC) -o $@ $^
%.o: %.cpp $(CC) $(CFLAGS) -c $< -o $@
-include $(DEPS)
%.d: %.cpp $(CC) $(CFLAGS) -MM $< > $@.$$$$; \ sed 's,($).o[ :],\1.o $@ : ,g' < $@.$$$$ > $@; \ rm -f $@.$$$$
-include $(DEPS) 让 Make 尝试加载自动生成的依赖文件（如 main.d），即使还没生成也不报错；sed 那行是为了把 main.o: main.cpp a.h 改成 main.o main.d: main.cpp a.h，确保改头文件后 .o 和 .d 一起重建。
不加这步，改了 a.h 后 make 可能完全不重新编译，导致静默错误。
clean、install、debug 这些伪目标怎么加才不踩坑
伪目标（phony target）必须显式声明，否则当目录下真有叫 clean 的文件时，Make 会跳过执行。
-
.PHONY: clean install debug必须写在最前面或逻辑清晰的位置 -
clean命令里用-rm（开头加短横）忽略“文件不存在”错误，避免中断 -
install如果要复制到系统路径（如/usr/local/bin），记得加sudo提示或检查权限，别默认假设用户有 root
示例片段：
.PHONY: clean debug installclean: -rm -f app $(OBJS) $(DEPS)
debug: $(MAKE) CFLAGS="$(CFLAGS) -g -O0"
install: cp app /usr/local/bin/
注意 debug 里用了 $(MAKE) 而不是直接调 make，这是递归调用的安全写法，能继承当前 Make 的所有环境和参数。
为什么改了头文件有时还是不重编？关键在依赖生成时机
依赖文件（.d）只在第一次编译或对应源文件变动时生成。如果删了 .d 文件但没动 .cpp，Make 不知道该不该重生成它，就会漏掉头文件变化。
更稳健的做法是在 clean 里删掉 .d，并在主目标里加一条强制更新依赖的逻辑：
app: $(OBJS) $(DEPS)
$(CC) -o $@ $^同时确保 %.d 规则在 %.o 之前定义（Make 按顺序解析，先匹配到的规则优先）。否则可能 .o 先生成了，.d 还没来得及建，后续依赖就失效。
这不是理论问题——实际项目里，协作时有人手动删了中间文件、CI 环境清理不彻底、或者 IDE 和 Makefile 混用，都容易触发这类隐性编译错误。
