Makefile循环依赖问题求助：预期输出与实际结果不符

你遇到的问题核心在于Makefile规则的展开方式错误，导致依赖关系完全不符合你的预期，进而出现循环依赖和错误的输出。

先还原你的问题场景：

你的Makefile代码 #

letters= a b c d
default:$(letters)
$(letters):x/x_$(letters)
x/x_$(letters):
	echo $@

预期输出 #

x/x_a x/x_b x/x_c x/x_d

实际输出 #

echo x/x_a x/x_a
make: Circular b <- b dependency dropped.
make: Circular c <- b dependency dropped.
make: Circular c <- c dependency dropped.
make: Circular d <- b dependency dropped.
make: Circular d <- c dependency dropped.
make: Circular d <- d dependency dropped.
echo d d
echo c c
echo b b

问题根源拆解 #

1. 规则展开错误，导致依赖混乱
   当Make展开$(letters)时，你的规则$(letters):x/x_$(letters)会被解析成：

   a b c d: x/x_a x/x_b x/x_c x/x_d
   

   这意味着*每个字母目标（a、b、c、d）都依赖所有的x/x_文件，而不是你预期的“a依赖x/x_a，b依赖x/x_b”这种一对一的关系。

2. 循环依赖的由来
   当Make尝试构建目标b时，它需要先构建所有依赖的x/x_*文件。但规则展开后的歧义导致Make误判了依赖路径，认为b等目标存在自依赖或交叉依赖的循环，从而抛出“Circular dependency”警告。

3. 输出不符合预期的原因
   你的x/x_$(letters):规则本身展开是正确的，但因为前面的字母目标依赖全部x/x_*文件，Make在执行时会重复触发命令，再加上依赖混乱导致的目标优先级偏移，最终输出完全偏离了你的预期。

修复方案 #

你需要用静态模式规则来实现“每个字母对应自己的x/x_文件”的一对一依赖关系，有两种常见写法：

方案1：直接构建x/x_*目标（更简洁）

letters= a b c d
# 直接把default目标设为所有x/x_*文件
default: $(addprefix x/x_, $(letters))

# 用静态模式匹配每个x/x_%文件
$(addprefix x/x_, $(letters)): x/x_%:
	echo $@

方案2：通过字母目标中转（保留你的原始思路）

letters= a b c d
default: $(letters)

# 静态模式规则：每个字母目标%依赖对应的x/x_%
$(letters): %: x/x_%

# 匹配所有x/x_%文件的构建规则
x/x_%:
	echo $@

两种方案执行后，都会输出你预期的结果：

echo x/x_a
x/x_a
echo x/x_b
x/x_b
echo x/x_c
x/x_c
echo x/x_d
x/x_d

内容的提问来源于stack exchange，提问作者vijayvithal