在大型C++项目中，编译速度常常成为开发效率的瓶颈。使用预编译头（Precompiled Headers, PCH）是一种有效提升编译速度的技术。它的核心思想是：将频繁包含且不常改动的头文件预先编译成二进制格式，后续编译时直接加载，避免重复解析和处理。

什么是预编译头（PCH）

预编译头是编译器将一组头文件（如标准库、第三方库或项目公共头）的解析结果保存为中间形式（.pch 或 .gch 文件），供其他源文件复用。这样，多个.cpp文件包含相同头文件时，不再需要每次都从头解析。

常见场景：每个源文件都包含 #include 、#include 、#include "common.h" 等，这些内容可以集中预编译。

如何在项目中启用PCH

不同编译器对PCH的支持方式略有差异，以下是GCC/Clang和MSVC的典型用法。

GCC 和 Clang 使用 .h.gch 作为预编译头输出文件名。编译器在遇到头文件时会自动查找同名的 .gch 文件。

步骤：

• 创建一个包含常用头的头文件，例如 stdafx.h：

#include
#include
#include iostream>
#include "common.h"

• 先预编译该头文件：

g++ -x c++-header stdafx.h -o stdafx.h.gch

这会生成 stdafx.h.gch。之后所有包含 stdafx.h 的源文件都会自动使用这个预编译结果。

• 在源文件中包含该头（必须是第一个 include）：

#include "stdafx.h"
#include "myclass.h"

注意：#include "stdafx.h" 必须是 .cpp 文件中的第一个非注释行，否则不会使用PCH。

MSVC 对 PCH 支持更完善，默认使用 stdafx.h 和 stdafx.cpp 结构。

AI驱动的矢量插图库和插图生成平台

配置方法：

• 创建 stdafx.h，包含常用头文件；
• 创建 stdafx.cpp，仅包含：#include "stdafx.h"；
• 在项目设置中开启“使用预编译头”（/Yc）针对 stdafx.cpp；
• 其他源文件设置为“使用预编译头”（/Yu）；
• 指定预编译头文件名，如 stdafx.h；
• 编译时，stdafx.cpp 会生成 .pch 文件。

现代 Visual Studio 版本也支持 pch.h / pch.cpp 命名，并可通过项目属性调整PCH设置。

使用PCH的注意事项

虽然PCH能显著加快编译，但使用不当反而影响效率或引发问题。

• 保持PCH头稳定：一旦PCH头文件变更，所有依赖它的源文件都需要重新编译。应避免将频繁修改的头放入PCH。
• 合理选择内容：只将真正通用、体积大、解析耗时的头加入PCH，如标准库、Boost、Qt等。项目局部头慎入。
• 包含顺序很重要：使用PCH的源文件中，PCH头必须是第一个 #include，否则PCH失效。
• 跨平台兼容性：.gch 或 .pch 文件不可移植，需在每个环境重新生成。
• 增量构建配合：结合 Ninja、ccache 等工具可进一步优化整体构建流程。

现代替代方案：模块（C++20 Modules）

C++20 引入了模块（Modules），是比PCH更先进、更安全的编译优化方式。模块不会受宏污染、作用域清晰、支持分离接口与实现，且加载速度更快。

虽然目前普及度还在推进中，但对于新项目，建议评估使用模块替代传统头文件和PCH。

示例（MSVC）：

import ;
import mymodule;

长远来看，模块将逐步取代PCH。

基本上就这些。正确使用预编译头，能在现有项目中显著缩短编译时间，尤其适合头文件依赖复杂的大型工程。关键是选好内容、保持稳定、注意包含顺序。随着C++20模块普及，未来会有更优雅的解决方案。