Makefile调试技巧：打印信息与变量调试

zhang-ge2026-04-16 16:23

在Makefile开发过程中，调试构建流程和变量展开是常见需求。本文系统梳理了Makefile中打印调试信息的多种方法。

1.常用打印方法

1.1.使用echo命令

echo 命令需在目标规则中使用，配合 @ 符号可隐藏命令本身：
bash 复制代码
```
print_message:
@echo "This is a debug message"
@echo "Current directory: $(CURDIR)"
```
关键点：
- @ 符号控制命令显示
- 适合在目标规则内打印

1.2.Makefile内置打印函数

三种内置函数可在任意位置使用：

bash 复制代码

$(info "This is an info message")      # 普通信息
$(warning "This is a warning message")  # 带行号警告
$(error "This is an error message")    # 终止执行错误

变量打印示例：

bash 复制代码

VAR = "Hello, World"
$(info "Value of VAR: $(VAR)")

2.变量调试技巧

变量展开时机控制 Makefile变量有两种展开方式：

展开方式	语法	特点
立即展开	`:=`	定义时展开
延迟展开	`=`	使用时展开

示例对比：

bash 复制代码

IMMEDIATE_VAR := $(shell date)  # 定义时固定
LAZY_VAR = $(shell date)        # 每次调用更新

print_vars:
    @echo "Immediate: $(IMMEDIATE_VAR)"
    @echo "Lazy: $(LAZY_VAR)"

3.命令预览与调试

命令	功能
`make -n`	显示但不执行命令
`make -d`	输出详细调试信息

使用示例：

bash 复制代码

make -n print_message  # 预览执行流程
make -d print_message  # 详细调试输出

4.规则导出分析

使用make -p导出所有规则和变量到文件：

bash 复制代码

make -p > make_db.txt

5.完整调试示例

bash 复制代码

# 变量定义
VAR = "Hello, Makefile"
IMMEDIATE_VAR := $(shell date)
LAZY_VAR = $(shell date)

# 调试信息
$(info "Makefile parsing started")
$(warning "Current SHELL: $(SHELL)")

# 目标规则
print_vars:
    @echo "--- Debug Output ---"
    @echo "VAR: $(VAR)"
    @echo "Immediate: $(IMMEDIATE_VAR)"
    @echo "Lazy: $(LAZY_VAR)"

# 默认目标
all: print_vars