在大型C++项目中，编译速度常常成为开发效率的瓶颈。使用预编译头（Precompiled Headers, PCH）是一种有效提升编译速度的技术。它的核心思想是：将频繁包含且不常改动的头文件预先编译成二进制格式，后续编译时直接加载，避免重复解析和处理。
什么是预编译头（PCH）
预编译头是编译器将一组头文件（如标准库、第三方库或项目公共头）的解析结果保存为中间形式（.pch 或 .gch 文件），供其他源文件复用。这样，多个.cpp文件包含相同头文件时，不再需要每次都从头解析。
常见场景：每个源文件都包含 #include
如何在项目中启用PCH
不同编译器对PCH的支持方式略有差异，以下是GCC/Clang和MSVC的典型用法。
立即学习“C++免费学习笔记（深入）”；
■ GCC 和 ClangGCC 和 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 结构。
配置方法：
- 创建 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模块普及，未来会有更优雅的解决方案。
