在C++项目开发过程中,随着项目规模扩大,代码中引入的头文件越来越多,每次编译时编译器都需要重复解析大量稳定的头文件,这会消耗大量时间。PCH预编译头就是为了解决这类重复解析问题而诞生的技术。
PCH预编译头是什么
PCH全称为Precompiled Header,也就是预编译头。它的核心作用是把项目中那些很少变动、会被多个源文件频繁引用的头文件,提前编译成一种二进制的中间格式保存起来。后续其他源文件编译时,不需要再重新解析这些头文件,直接加载预编译好的二进制内容即可,从而减少重复的解析工作。
常见的稳定头文件包括标准库头文件如<iostream>、<vector>,以及项目内长期不变的公共头文件、第三方库的固定版本头文件等。这些头文件一旦修改才需要重新生成PCH,日常开发中大部分时间都可以复用已有的PCH文件。
PCH的工作原理
编译器处理PCH的流程可以分为两个阶段:
- 第一阶段是生成PCH:编译器读取指定的头文件集合,解析其中的语法、类型定义、宏定义等内容,把所有解析后的信息序列化保存到PCH文件中,这个文件通常是二进制格式,不同编译器的PCH文件后缀和格式会有差异,比如MSVC用的是.pch后缀,GCC用的是.gch后缀。
- 第二阶段是使用PCH:当编译普通的.cpp源文件时,编译器会先检查是否存在对应的PCH文件,如果存在且PCH依赖的头文件没有发生变动,编译器就会直接加载PCH中的已解析内容,跳过对这些头文件的重复解析过程,直接进入源文件本身的编译环节。
如何配置PCH加快编译速度
1. 选择合适的头文件放入PCH
不是所有头文件都适合放进PCH,只有符合以下特征的头文件才适合:
- 很少发生变动,比如标准库头文件、第三方库的稳定版本头文件。
- 被大量源文件引用,如果某个头文件只被一两个源文件引用,放进PCH反而会增加不必要的开销。
- 不包含频繁修改的项目内业务头文件,否则每次修改业务头文件都要重新生成PCH,反而会降低效率。
2. 不同编译器的PCH配置示例
MSVC编译器配置
首先在项目中创建一个预编译头文件,通常命名为pch.h,内容如下:
// pch.h 预编译头文件内容 #ifndef PCH_H #define PCH_H #include <iostream> #include <vector> #include <string> #include <map> // 引入第三方库稳定头文件 #include <opencv2/opencv.hpp> #endif // PCH_H
然后创建对应的pch.cpp文件,内容很简单,只需要包含pch.h:
// pch.cpp 用于生成PCH文件 #include "pch.h"
在MSVC的项目属性中,设置预编译头选项为“使用(/Yu)”,预编译头文件填写pch.h,同时把pch.cpp的预编译头选项设置为“创建(/Yc)”,这样编译时就会先生成pch.pch文件,其他源文件编译时自动使用这个PCH。
GCC编译器配置
首先创建预编译头文件common.h,内容和上面的pch.h类似,然后执行以下命令生成PCH:
g++ -std=c++11 common.h -o common.h.gch
后续编译其他源文件时,只要common.h.gch存在且common.h没有修改,GCC会自动使用这个预编译头:
g++ -std=c++11 main.cpp -o main
3. 工程化场景下的PCH管理注意事项
- 把PCH文件纳入版本控制时要谨慎,因为PCH是和编译器版本、编译参数强绑定的,不同环境生成的PCH可能不通用,通常建议把PCH的生成规则写入构建脚本,每次构建时自动判断是否需要重新生成PCH,而不是直接提交PCH文件到代码仓库。
- 定期清理无效的PCH文件,当编译器版本升级或者项目编译参数修改后,旧的PCH文件会失效,需要及时删除重新生成。
- 对于超大型项目,可以按照模块拆分多个PCH,不同模块使用对应的PCH,避免单个PCH过大导致的加载开销。
其他C++编译加速技巧
除了使用PCH之外,还有很多工程化技巧可以加快C++的编译速度:
- 使用前向声明减少头文件依赖,在头文件中尽量使用前向声明代替直接包含其他头文件,比如声明
class MyClass;而不是#include "MyClass.h",这样可以减少头文件的嵌套引用,降低编译时的依赖解析开销。 - 开启编译器的并行编译选项,MSVC可以使用
/MP参数开启多核并行编译,GCC和Clang可以使用-j参数指定并行任务数,比如make -j8使用8个线程并行编译。 - 合理使用模块特性,C++20引入了模块机制,相比传统的头文件,模块可以实现更好的封装和编译隔离,减少重复解析的问题,不过目前模块的生态还在完善中,适合新项目尝试。
- 拆分大型头文件,把一个包含大量内容的大头文件拆分成多个小的功能单一的头文件,这样源文件只需要包含自己需要的部分,减少不必要的头文件解析。
总结
PCH预编译头是C++工程化编译优化中非常实用的手段,通过提前编译稳定的头文件,能够有效减少重复解析带来的时间消耗,尤其适合中大型项目。在实际使用中,需要合理选择放入PCH的头文件,结合不同编译器的特性正确配置,同时配合其他编译优化技巧,才能最大程度提升编译效率,减少开发过程中的等待时间。