预编译头通过将常用头文件预先编译成二进制格式，避免重复解析，显著提升C++编译速度。
预编译头（Precompiled Headers，简称 PCH）是 C++ 编译过程中用来加速编译速度的一种技术。它的核心作用是将频繁使用且不常变动的头文件预先编译成二进制格式，避免在每次编译源文件时重复解析这些头文件，从而显著减少编译时间。
预编译头的作用：为什么需要 PCH？
C++ 项目中通常会包含大量标准库或第三方库的头文件，比如 <iostream>、<vector>、<string> 等。这些头文件内容庞大，且被多个源文件包含。每次编译一个 .cpp 文件时，编译器都要从头开始解析这些头文件及其嵌套包含的所有内容，这个过程非常耗时。
预编译头通过提前把常用头文件的解析结果保存下来，后续编译可以直接复用，跳过重复的词法分析、语法分析和语义检查阶段，大幅缩短编译时间。
PCH 加速编译的原理
编译器处理头文件时，主要经历以下几个阶段：
立即学习“C++免费学习笔记（深入）”；
- 读取头文件内容
- 进行宏展开、条件编译处理
- 词法与语法分析，生成抽象语法树（AST）
- 完成类型检查和符号解析
预编译头就是将上述过程的结果以二进制形式缓存起来。当某个源文件包含相同的头文件序列时，编译器可以直接加载已编译好的 AST 数据，而不是重新走一遍完整的解析流程。
关键点在于：PCH 必须在所有源文件之前一致地包含相同的头文件序列。如果某个文件包含顺序不同或缺少前置头文件，就无法使用预编译头。
如何设置和使用预编译头
不同编译器对预编译头的支持方式略有差异，以下是常见环境下的配置方法。
Visual Studio（MSVC）中的设置
Visual Studio 默认支持预编译头，常用配置如下：
- 创建一个头文件，通常命名为 stdafx.h 或 pch.h，放入最常用的稳定头文件：
// pch.h #pragma once #include <iostream> #include <vector> #include <string> #include <memory> // 其他常用头文件
- 创建对应的源文件 pch.cpp，并确保它只包含这个头文件：
// pch.cpp #include "pch.h" // 留空或仅用于触发预编译 </font> </ol> <ol start="3"> <li>在项目属性中启用预编译头：</li> <li>右键项目 → 属性 → C/C++ → 预编译头 → 设置为“使用预编译头 (/Yu)”</li> <li>指定预编译头文件名，如 <strong>pch.h</strong></li> <li>对于 <strong>pch.cpp</strong>，单独设置为“创建预编译头 (/Yc)”</li> </ol> <p>其他所有源文件必须在第一行包含 <strong>#include "pch.h"</strong>，否则无法使用预编译头。</p> <H3>gcc / clang 中的使用方法</H3> <p>GCC 和 Clang 使用 <strong>.gch</strong> 文件作为预编译头的输出格式。</p> <ol> <li>编写头文件，例如 <strong>common.h</strong>：</li> </ol> <font face="Courier New"> <pre class="brush:php;toolbar:false;"> // common.h #include <iostream> #include <vector> #include <string>
- 手动预编译该头文件：
g++ -x c++-header common.h -o common.h.gch
这会生成 common.h.gch 二进制缓存文件。
- 之后编译其他源文件时，只要包含 #include "common.h"，编译器会自动优先使用 .gch 文件。
注意：.gch 文件必须与原头文件在同一目录，且编译选项（如宏定义、语言标准）需一致，否则不会生效。
最佳实践与注意事项
- 只将稳定不变、广泛使用的头文件放入预编译头，避免频繁修改 pch.h，否则每次修改都会导致全部源文件重新编译。
- 保持所有源文件包含预编译头的方式一致，且必须是第一个 include。
- 现代 C++ 项目可考虑结合 模块（Modules） 替代预编译头，进一步提升编译效率（C++20 支持）。
- 大型项目建议配合构建系统（如 CMake）自动化管理 PCH 配置。
基本上就这些。预编译头虽不是银弹，但在传统包含模型下，它是优化编译速度最直接有效的方法之一。正确使用能带来数倍的编译提速，尤其适合中大型工程项目。
