使用Makefile配置GCC预编译头pch.h时出现编译错误如何解决

你遇到的! ./pch.h.gch是GCC的-H参数输出的标记，含义是当前预编译头文件无法被匹配使用，因此直接中断编译，对应的配置错误和修复方案如下：

1. 清理规则缺失预编译头文件 #

你当前的clean规则没有删除.gch后缀的预编译头，每次修改编译参数、更新pch.h内容后，旧的预编译头会残留在目录中，和新的编译参数/头文件内容不匹配，就会触发无法使用的报错。
修复：修改clean规则为：

clean:
    rm *.o *.gch runPeykNowruzi

之后每次需要全量重编时执行make clean即可清理所有旧产物，不会有残留。

2. 预编译头生成规则缺少显式类型声明 #

MinGW环境下偶尔会出现头文件类型识别错误的问题，建议在生成预编译头的命令中添加-x c++-header参数，显式声明这是C++预编译头，避免识别异常。
修复：修改pch.h.gch的生成规则为：

pch.h.gch: pch.h
    $(CXX) -c $(CXXFLAGS) -x c++-header pch.h -o pch.h.gch

3. 不可删除原始pch.h文件 #

你删除pch.h后编译失败是正常现象：GCC使用-include pch.h参数时，首先会查找原始pch.h文件，再匹配是否有对应可用的.gch预编译头，原始头文件是必选的，预编译头只是加速编译的缓存文件，不能替代原始头文件。

可选排查方案 #

如果后续再遇到预编译头无法使用的问题，可以在CXXFLAGS中添加-Winvalid-pch参数，GCC会直接输出预编译头无法使用的具体原因（比如参数不匹配、头文件更新时间晚于预编译头等），方便快速排查。

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