C预编译输出出现头文件重定义错误的原因及单翻译单元输出方法

1. 猜测正确性验证 #

你的猜测完全正确，实际原因如下：

• 当你向gcc -E传入多个.c源文件时，GCC会将每个.c作为独立翻译单元分别执行预编译，每个翻译单元的预处理器上下文（包括宏定义、头文件保护标记）完全独立，所有翻译单元的预编译结果会按顺序拼接输出到同一个目标文件中。
• 头文件保护宏仅在单个翻译单元的预编译过程中生效，无法跨翻译单元阻止重复展开。因此拼接后的单一.i文件中会存在大量重复的类型定义、函数声明，编译时自然会报重定义错误。
• 正常直接调用GCC编译多个源文件时，每个翻译单元会独立完成编译生成.o目标文件，最后由链接器处理符号合并规则，因此不会触发该错误。

2. 单独输出每个翻译单元预编译文件的方法 #

有两种常用实现方案：

方案1：逐个处理源文件（灵活可控，适合自定义修改流程） #

通过shell循环对每个.c文件单独执行预编译，生成对应独立的.i文件，修改完成后再统一编译所有.i文件即可，示例代码：

#!/bin/bash
# 提前创建所需目录
mkdir -p build bin prebuild

# 预编译所有.c文件，每个输出独立的.i文件
for c_file in debug/*.c src/*.c; do
    file_basename=$(basename "$c_file" .c)
    gcc -E "$c_file" -o prebuild/"$file_basename".i
done

# 此处可添加对prebuild目录下所有.i文件的自定义修改逻辑

# 编译所有修改后的.i文件生成最终可执行文件
gcc -Wpointer-arith -Wall prebuild/*.i -o bin/main.exe

方案2：使用-save-temps参数（操作简单，适合快速测试） #

在正常编译命令中添加-save-temps参数，GCC编译过程中会自动保留每个翻译单元对应的预编译.i文件、汇编.s文件、目标.o文件，默认输出到当前工作目录：

gcc -Wpointer-arith -Wall -save-temps -o bin/main.exe debug/*.c src/*.c

如果需要将中间文件统一输出到指定目录，可以使用-save-temps=obj参数，配合-o指定目标路径即可。

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