如何确认GCC是否使用pch.h.gch预编译头及相关生成、防护问题

如何检查GCC是否调用了预编译头 #

你可以通过两个编译参数直接验证：

• 编译时添加-H参数：如果预编译头被成功调用，输出的头文件列表中，对应的预编译头路径会带有!前缀；如果未命中，会显示x前缀表示忽略该预编译头，fallback到编译原始.h文件。
• 编译时添加-v参数：在头文件搜索路径的输出日志中，可以直接看到GCC是否尝试读取匹配的.gch文件，以及读取是否成功。

生成预编译头未携带.gch后缀的原因 #

该问题通常由以下几个原因导致：

1. 未显式指定输入文件类型：GCC编译C++头文件时如果没有添加-x c++-header参数，可能会错误判断输入文件类型，导致生成的文件不符合预编译头命名规则。建议调整命令为：

g++ -std=c++20 -Wall -O3 -flto -x c++-header pch.h -o pch.h.gch

如果你不需要自定义输出路径，也可以直接去掉-o参数，GCC默认会生成pch.h.gch文件。
2. 源文件残留或编译失败：如果当前目录原有pch.h文件，且你的编译命令执行出错（比如pch.h存在语法错误、参数不兼容），不会生成新的.gch文件，你看到的实际是原始的头文件。可以先删除目录下的pch相关文件再重新执行命令验证。
3. 部分GCC版本对带-flto参数的预编译头生成支持有异常：如果调整参数后仍然有问题，可以尝试暂时去掉-flto参数生成预编译头，确认命名是否恢复正常。

预编译头是否需要添加包含防护 #

需要，和普通头文件的要求一致：

• 不管是否做预编译处理，头文件本身都需要添加包含防护（#pragma once或者#ifndef宏守卫），避免多次包含导致的重复定义、符号重声明错误。
• GCC加载预编译头后，仍然会校验原始头文件的包含防护状态，如果防护已触发，会直接跳过后续处理，反而能进一步提升编译效率。

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