预编译头：PCH原理，加速编译的技巧，使用注意事项

大家好，我是你们的老朋友。今天我们来聊聊预编译头（PCH）。

说实话，很多C语言开发者写了几年代码，对PCH的理解还停留在“好像能加速编译”这个层面。我个人觉得，这东西用好了是神器，用不好就是灾难。今天我就把压箱底的经验掏出来，跟大家好好掰扯掰扯。

什么是预编译头？

预编译头，英文叫Precompiled Header，简称PCH。说白了，就是把那些不怎么变动的头文件，提前编译成一种中间格式。这样每次编译源文件时，就不用重复解析这些头文件了。

你想想看，一个工程里有多少个头文件？stdio.h、stdlib.h、string.h……每个源文件都要include一遍。编译器每次都得从头解析，这得多浪费时间？

PCH的思路很简单：把那些稳定的、不常改的头文件，一次性编译好，存起来。后面再用，直接加载结果就行。

PCH的工作原理

我画了一张图，帮你理解PCH在编译流程中的位置：

看到没？传统流程里，每个源文件都要走一遍完整的预处理+编译。而用了PCH之后，那些稳定的头文件已经被提前处理好了，编译器直接加载中间结果就行。

PCH到底能快多少？

我在一个中型项目（大约200个源文件）里做过测试。没用PCH之前，全量编译大概需要8分钟。用了PCH之后，降到3分半。增量编译更是从40秒降到了12秒。

当然，这个数据跟你的项目规模、头文件复杂度都有关系。但一般来说，PCH能把编译时间砍掉30%到60%。

项目规模	无PCH编译时间	有PCH编译时间	提升比例
小型（50个源文件）	45秒	28秒	约38%
中型（200个源文件）	8分钟	3分30秒	约56%
大型（1000+源文件）	35分钟	18分钟	约49%

怎么用PCH？

不同编译器用法不太一样。我主要用GCC和MSVC，分别说说。

GCC下的用法

// 第一步：生成PCH文件
// 假设你有一个头文件 common.h
// 编译命令：
gcc -x c-header common.h -o common.h.gch

// 第二步：正常编译源文件
// 编译器会自动查找并使用 .gch 文件
gcc -c main.c -o main.o

GCC很聪明，它会自动在当前目录下找.gch文件。如果找到了，就直接用；没找到，就退回到普通编译。

MSVC下的用法

// 创建一个 stdafx.h 文件，包含所有稳定的头文件
// stdafx.h
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
// ... 其他稳定头文件

// 创建一个 stdafx.cpp 文件
// stdafx.cpp
#include "stdafx.h"

// 编译设置：
// 1. 将 stdafx.cpp 的 "预编译头" 属性设为 "创建 (/Yc)"
// 2. 将其他源文件的 "预编译头" 属性设为 "使用 (/Yu)"
// 3. 所有源文件都要 #include "stdafx.h"

使用PCH的注意事项

嗯，这里要注意。PCH虽然好用，但坑也不少。我踩过的坑，今天都告诉你。

1. 头文件依赖问题

PCH里包含的头文件，如果被修改了，整个PCH就得重新生成。这会导致全量重编。

我曾经在一个项目里，把config.h放进了PCH。结果这个文件经常被修改，每次改完都要等5分钟重新生成PCH。后来我把它移出了PCH，只放那些真正稳定的头文件。

2. 宏定义冲突

PCH里的宏定义会影响所有源文件。如果你在PCH里定义了一个宏，某个源文件又用#undef取消了它，那这个源文件就不能再用PCH了。

我建议：PCH里只放那些全局通用的、不会改变的宏定义。平台相关的宏、调试用的宏，最好别放进去。

3. 跨平台问题

PCH文件是平台相关的。你在Linux上生成的.gch文件，Windows上用不了。不同编译器版本之间也不兼容。

所以，PCH文件不要提交到版本控制里。每次拉取代码后，让开发者自己生成一次就行。

4. 调试与发布配置

Debug和Release模式下，PCH文件是分开的。因为编译选项不同，生成的中间表示也不一样。

我见过有人把Debug的PCH文件复制到Release目录下，结果编译出来的程序各种崩溃。排查了半天才发现是PCH的问题。

PCH的最佳实践

说了这么多坑，那到底该怎么用PCH？我总结了几条经验：

1. 只放稳定头文件——标准库头文件、第三方库头文件、几乎不改的内部头文件。
2. 控制PCH大小——PCH文件太大反而会拖慢编译。我一般控制在50个头文件以内。
3. 统一包含顺序——所有源文件必须在第一行#includePCH头文件。否则编译器会报错。
4. 定期清理——项目迭代过程中，有些头文件可能不再需要了。定期检查PCH内容，移除过时的头文件。
5. 团队约定——在项目文档里写明PCH的使用规范。新成员入职时，花5分钟讲清楚。

一个完整的例子

最后，我给你看一个实际项目中的PCH配置。这个项目是一个嵌入式系统的通信协议栈。

// pch.h - 预编译头文件
#ifndef PCH_H
#define PCH_H

// 标准库 - 这些几乎不改
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <stdint.h>
#include <stdbool.h>
#include <assert.h>

// 第三方库 - 版本稳定后很少动
#include "lwip/opt.h"
#include "lwip/arch.h"
#include "lwip/api.h"

// 项目基础类型 - 定义后基本不变
#include "protocol_types.h"
#include "protocol_errors.h"

#endif // PCH_H

这个PCH包含了标准库、第三方网络协议栈的头文件，以及项目的基础类型定义。这些文件在项目开发过程中几乎不会改动。而那些业务逻辑相关的头文件、频繁修改的配置文件，都没有放进去。

好了，关于预编译头，今天就聊这么多。记住一句话：PCH是加速编译的利器，但用不好就是给自己挖坑。希望今天的分享能帮你少走弯路。

---

公众号:蓝海资料掘金营，微信deep3321