基于Makefile实现C语言模块条件编译测试的问题求助

1. 先明确项目文件结构示例 #

假设你的项目结构如下（若实际结构不同，对应调整路径即可）：

project/
├── src/
│   ├── module_a.c
│   ├── module_a.h
│   ├── module_b.c
│   └── module_b.h
├── tests/
│   ├── test_module_a.c
│   ├── test_module_b.c
│   └── test_runner.c
└── Makefile

2. 确认测试文件的条件编译规范 #

确保每个测试文件的main函数用#ifdef包裹，比如test_module_a.c：

#include "module_a.h"
#include <stdio.h>

void test_module_a() {
    // 模块A的测试逻辑
    printf("Running module A tests...\n");
}

#ifdef RUN_STANDALONE_TEST
int main() {
    test_module_a();
    return 0;
}
#endif

3. 适配需求的Makefile编写 #

以下Makefile支持全量运行所有测试和单独运行指定模块测试：

# 基础编译配置
CC = gcc
CFLAGS = -Wall -Wextra -I./src
TEST_DIR = tests
SRC_DIR = src

# 自动匹配所有模块源文件
SRC_FILES = $(wildcard $(SRC_DIR)/*.c)
# 自动匹配所有测试文件（排除test_runner）
TEST_FILES = $(filter-out $(TEST_DIR)/test_runner.c, $(wildcard $(TEST_DIR)/*.c))
# 自动生成单独测试目标（比如test_module_a、test_module_b）
TEST_TARGETS = $(patsubst $(TEST_DIR)/test_%.c, test_%, $(TEST_FILES))

# 默认目标：执行全量测试
all: test_all

# 全量测试规则：编译test_runner+所有模块+所有测试文件，不激活单个测试的main
test_all: $(SRC_FILES) $(TEST_FILES) $(TEST_DIR)/test_runner.c
	$(CC) $(CFLAGS) -o $@ $^
	./$@
	rm -f $@

# 单独测试规则：编译单个测试文件+对应模块，通过宏激活该测试的main
$(TEST_TARGETS): test_%: $(SRC_DIR)/%.c $(TEST_DIR)/test_%.c
	$(CC) $(CFLAGS) -DRUN_STANDALONE_TEST -o $@ $^
	./$@
	rm -f $@

# 清理生成的测试可执行文件
clean:
	rm -f test_all $(TEST_TARGETS)

4. 使用方式 #

• 全量运行所有测试：执行 make 或 make test_all
• 单独运行某模块测试：比如运行模块A的测试，执行 make test_module_a
• 清理测试产物：执行 make clean

关键逻辑说明 #

• TEST_TARGETS 通过模式匹配自动生成所有单独测试目标，新增模块测试无需手动修改Makefile
• 单独测试时通过-DRUN_STANDALONE_TEST宏定义激活对应测试文件的main函数
• 全量测试时不定义该宏，所有测试文件的main被屏蔽，统一使用test_runner.c中的入口调用所有测试函数

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