GNU Make 怎么查看最终生效的变量和规则

复杂 Makefile 最难排查的不是“有没有写规则”，而是 include 文件、命令行变量和内置规则展开后，GNU Make 到底采用了什么。查看最终结果时，直接使用 make -qp：-p 打印读取后的数据目录，-q 让 Make 不执行配方。这样可以把变量值、显式规则和模式规则保存下来，再按名称追溯来源。

官方地址：https://www.gnu.org/software/make/manual/make.html

步骤一：把最终数据目录保存到可复查文件

操作路径是“项目目录 → Make 参数输入框 → 输出文件字段”。在项目根目录运行下面的命令，把标准输出和错误输出分开保存。命令中的中文注释说明了每个文件的用途。

# 导出读取 Makefile 后的变量与规则，不执行配方
make -qp > make-database.txt 2> make-database.err

# 打印本次查询的退出码，便于区分目标状态和真正的错误
status=$?
echo "make -qp exit=$status"

结果面板中应出现变量定义、目标规则和模式规则的分段内容。make-database.err 用来单独查看语法错误、缺失 include 文件等问题；不要只看最后一行输出就认定规则不存在。

步骤二：先按变量名搜索，再看定义来源

操作路径是“数据目录 → Variables 分组 → 变量名筛选框”。例如项目实际使用 CC、CFLAGS 或自定义的 BUILD_MODE 时，先找到变量的最终值，再向下阅读它旁边的文件名和行号。最终值可能经过多个赋值语句覆盖，数据目录展示的是合并后的结果，不代表只有一处定义。

# 从变量区快速定位关键名称，避免把整份数据库复制到终端
grep -nE '^(CC|CFLAGS|BUILD_MODE)[[:space:]]*[:+?]?=' make-database.txt

# 记录上下文行，连同文件名和行号一起回看变量来源
grep -n -A 4 -B 2 'BUILD_MODE' make-database.txt

这一步的验收标准是“知道最终取值，也知道它被谁覆盖”。如果变量看起来和预期不同，优先检查命令行参数、环境变量和被 include 的文件，而不是先修改生成逻辑。

步骤三：分别查看显式规则和模式规则

操作路径是“数据目录 → Rules 分组 → 目标名或模式规则筛选框”。显式规则适合定位 app: app.o 这类目标关系，模式规则则常见于 %.o: %.c。查看时按“目标 → 前置条件 → recipe”顺序阅读，确认它究竟来自项目 Makefile、某个 include 文件，还是 GNU Make 的内置规则。

# 查看目标规则周围的上下文，便于同时看到前置条件和 recipe
grep -n -A 8 -B 2 '^app:' make-database.txt

# 搜索常见的 C 文件模式规则，不把它误判成具体目标
grep -n -A 8 -B 2 '^%\.o: %\.c' make-database.txt

如果同一个目标可以匹配多条模式规则，不要只凭规则名称下结论；继续阅读前置条件和定义位置，结合实际目标文件的后缀与依赖关系判断哪条规则会被采用。

步骤四：用退出码和摘要面板完成结果核对

操作路径是“结果面板 → Status 字段 → 变量/规则摘要 → 归档记录”。-q 会检查目标是否需要更新：退出码 0 表示目标已是最新，1 表示需要更新，2 才表示遇到错误。因此，即使 make -qp 返回 1，只要 make-database.txt 已生成，就应先阅读数据目录，再决定是否处理构建状态。

# 将退出码写进归档记录，保留本次数据目录的判断背景
echo "query_status=$status" > make-database.status

# 只复制关键结论，方便提交排查记录而不是提交完整日志
grep -nE '^(CC|CFLAGS|BUILD_MODE)[[:space:]]*[:+?]?=|^app:|^%\.o:' make-database.txt > make-database.summary

最后核对三件事：关键变量的值是否符合当前构建场景；目标规则的前置条件是否完整；模式规则是否来自预期文件。确认后可以把 make-database.txt、状态文件和摘要一起归档。这个流程只读取最终数据库，不修改 Makefile，也不会改变实际构建并发度。

常见问题

为什么 make -qp 返回 1？

退出码 1 表示指定目标需要更新，是 -q 的正常判断结果；退出码 2 才表示遇到错误。请结合错误文件和数据目录一起判断。

数据目录里为什么有很多看似无关的规则？

GNU Make 会把内置规则和读取到的 include 内容一起放进数据库。先按目标名、变量名或模式筛选，再阅读定义文件和行号，不要把整份数据库当成项目专属规则清单。

只想看项目规则，能不能去掉内置规则？

可以在排查时额外考虑 -r，但它会改变参与规则查找的内置规则集合。本文的 make -qp 保留完整环境，适合先确认“最终实际可见的规则”。