Makefile中foreach循环丢失前项路径问题排查与解决咨询

项目结构如下：

Project_root
+- Makefile
+- main.c
+- main.h
+- Module_1
|  +- src
|  |  +- unit_test
|  |  |  +- Module_1_test.c
|  |  |  +- Module_1_test.h
|  |  +- Module_1.c
|  |  +- Module_1.h
+- Module_2
|  +- src
|  |  +- unit_test
|  |  |  +- Module_2_test.c
|  |  |  +- Module_2_test.h
|  |  +- Module_2.c
|  |  +- Module_2.h
...

编写的Makefile片段：

TARGET_LIBS += Module_1
TARGET_LIBS += Module_2

...

DEPS = ${foreach SRC, $(basename $(wildcard $(TARGET_LIBS)/src/*.c)), $(addsuffix .o, $(SRC))}
DEPS_TEST = ${foreach SRC, $(basename $(wildcard $(TARGET_LIBS)/src/unit_test/*.c)), $(addsuffix .o, $(SRC))}
DEPS_PATH = ${foreach LIB, $(TARGET_LIBS), $(LIB)/src}

all: $(DEPS) main.o
    gcc $(CFLAGS) main.o $(DEPS) $(CLIBS) -o main

test: $(DEPS) main.o
    gcc $(CFLAGS) main.o $(DEPS) $(CLIBS) -o main

...

$(DEPS):
    gcc $(CFLAGS) -c $(addsuffix .c, $(basename $(DEPS))) -I $(DEPS_PATH)

现象：

• 仅使用1个模块时变量正常：

  TARGET_LIBS -> Module_1
  DEPS -> Module_1/src/Module_1.o
  DEPS_TEST -> Module_1/src/unit_test/Module_1_test.o
  DEPS_PATH -> Module_1/src
  

• 添加多个模块后，DEPS异常：预期为Module_1/src/Module_1.o Module_2/src/Module_2.o，实际得到Module_1.o Module_2/src/Module_2.o，DEPS_TEST存在类似问题。

疑问：Makefile写法是否有误？假设哪里出错？希望得到解决方法及问题原因。

核心原因 #

1. 路径拼接逻辑错误：$(TARGET_LIBS)/src/*.c的写法不符合GNU make的展开规则。当TARGET_LIBS包含多个值（如Module_1 Module_2）时，该表达式会被展开为Module_1 Module_2/src/*.c，而非预期的Module_1/src/*.c Module_2/src/*.c。GNU make不会自动给列表中的每个元素添加后缀，只会给最后一个元素添加。
2. wildcard函数行为：wildcard会处理展开后的两个模式：
   • 第一个模式Module_1是存在的目录，wildcard会返回目录名Module_1；
   • 第二个模式Module_2/src/*.c匹配到Module_2/src/Module_2.c。
3. 后续函数处理：basename对Module_1（无后缀）返回原字符串，对Module_2/src/Module_2.c返回Module_2/src/Module_2；再通过addsuffix .o得到Module_1.o Module_2/src/Module_2.o，这就是你看到的异常结果。

解决方法 #

步骤1：修正路径拼接方式 #

使用addsuffix函数给每个模块添加路径后缀，确保每个模块都生成正确的源文件匹配模式：

# 生成每个模块的源文件匹配模式
SRC_PATTERNS = $(addsuffix /src/*.c, $(TARGET_LIBS))
# 生成每个模块的测试文件匹配模式
TEST_SRC_PATTERNS = $(addsuffix /src/unit_test/*.c, $(TARGET_LIBS))

步骤2：正确生成目标文件列表 #

用patsubst直接替换.c为.o，比basename+addsuffix更直观可靠，且无需多余的foreach循环：

DEPS = $(patsubst %.c, %.o, $(wildcard $(SRC_PATTERNS)))
DEPS_TEST = $(patsubst %.c, %.o, $(wildcard $(TEST_SRC_PATTERNS)))
# 生成头文件搜索路径（这里可以保留原有的foreach写法，或者用addsuffix简化）
DEPS_PATH = $(addsuffix /src, $(TARGET_LIBS))

步骤3：修正编译规则 #

原有的$(DEPS):规则是错误的——它会让所有.o文件共用同一个编译命令，导致编译逻辑混乱。改用静态模式规则结合自动变量，确保每个.o文件对应编译自己的.c文件：

# 静态模式规则：匹配每个模块的.o文件，编译对应的.c文件
$(DEPS): %.o: %.c
	gcc $(CFLAGS) -c $< -o $@ -I $(DEPS_PATH)

# 同理处理测试文件的编译
$(DEPS_TEST): %.o: %.c
	gcc $(CFLAGS) -c $< -o $@ -I $(DEPS_PATH)

修正后的关键片段 #

TARGET_LIBS += Module_1
TARGET_LIBS += Module_2

# 生成源文件匹配模式
SRC_PATTERNS = $(addsuffix /src/*.c, $(TARGET_LIBS))
TEST_SRC_PATTERNS = $(addsuffix /src/unit_test/*.c, $(TARGET_LIBS))

# 生成依赖文件列表
DEPS = $(patsubst %.c, %.o, $(wildcard $(SRC_PATTERNS)))
DEPS_TEST = $(patsubst %.c, %.o, $(wildcard $(TEST_SRC_PATTERNS)))
DEPS_PATH = $(addsuffix /src, $(TARGET_LIBS))

all: $(DEPS) main.o
	gcc $(CFLAGS) main.o $(DEPS) $(CLIBS) -o main

# 编译模块源文件
$(DEPS): %.o: %.c
	gcc $(CFLAGS) -c $< -o $@ -I $(DEPS_PATH)

# 编译测试文件
$(DEPS_TEST): %.o: %.c
	gcc $(CFLAGS) -c $< -o $@ -I $(DEPS_PATH)

额外注意事项 #

• 永远不要假设GNU make会自动给列表中的每个元素添加前缀/后缀，必须用addprefix/addsuffix函数处理。
• 替换文件后缀优先使用patsubst或$(VAR:.c=.o)语法，避免basename+addsuffix的冗余写法。
• 编译规则中必须使用自动变量（$<代表依赖文件，$@代表目标文件），确保每个目标都能正确编译对应的源文件。

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