为何启用预编译头后需在每个源文件中包含pch.hpp？

核心结论 #

是的，在VS启用/Yu（使用预编译头）的默认配置下，每个需要使用预编译头的.cpp源文件必须直接包含预编译头文件——哪怕该.cpp包含的头文件已经间接引入了预编译头，也无法替代直接包含的作用。

为什么间接包含不行？ #

VS的预编译头机制要求：预编译头文件必须是.cpp文件中第一个被处理的包含语句（或者至少在任何未预编译的代码之前），且必须是直接包含。编译器在处理.cpp文件的开头阶段就会检查是否有指定的预编译头包含，如果找不到直接的#include "pch.hpp"，就会判定违反预编译头使用规则，触发C1010错误。

间接包含（比如Vector.cpp包含Vector.hpp，而Vector.hpp包含pch.hpp）的情况下，编译器处理到Vector.hpp里的预编译头时，已经错过了预编译头的检查时机，因此不会识别为有效使用预编译头。

避免逐个修改.cpp文件的解决方案 #

如果你不想手动给大量.cpp添加#include "pch.hpp"，可以使用VS的强制包含文件功能：

• 打开项目属性 → 【C/C++】→ 【高级】
• 在“强制包含文件”一栏中填入pch.hpp（如果pch.hpp不在项目根目录，需要填写正确的相对路径，例如./include/pch.hpp）
• 应用配置后，编译器会自动在每个.cpp文件的最开头插入#include "pch.hpp"，无需手动修改源文件

如果有部分.cpp文件（比如第三方代码）不需要使用预编译头，可以单独对这些文件进行配置：

• 右键目标.cpp文件 → 【属性】→ 【C/C++】→ 【预编译头】
• 将“预编译头”设置为“不使用预编译头”即可

预编译头最佳实践补充 #

• 预编译头中只放入不常修改的头文件（如STL头、第三方库头），避免每次修改都触发预编译头重新生成，影响编译效率
• 确保预编译头的路径在所有.cpp中都能正确解析，必要时调整项目的【C/C++】→ 【常规】→ 【附加包含目录】

内容的提问来源于stack exchange，提问作者Phil-ZXX