c++oding="utf-8" ?>

预编译头文件（PCH）是C++编译器通过预先解析稳定头文件生成二进制中间表示以加速编译的优化机制；它要求选定入口头、单独编译生成PCH、其余源文件首行包含该头，并仅纳入高频且极少变更的标准库、公共头或稳定第三方头，配置不当易引发重编译或ODR错误。

预编译头文件（Precompiled Header，简称 PCH）是 C++ 编译器提供的一种优化机制，用来加速重复包含大量头文件（尤其是标准库、第三方库等稳定不变的头）的编译过程。

为什么需要 PCH？

大型项目中，每个 .cpp 文件常以 #include stream>、#include 、#include "common.h" 开头。这些头文件本身可能又嵌套包含几十个其他头，每次编译都要重新解析、词法分析、语法分析——即使内容从不改变。PCH 把这部分“稳定且通用”的头文件预先处理成二进制中间表示（如 GCC 的 .gch、MSVC 的 .pch），后续编译直接加载，跳过前端耗时步骤。

怎么用 PCH？（以常见工具链为例）

关键不是“写一个头”，而是“约定+配置”：

• 选一个头文件作为 PCH 入口：比如 StdAfx.h（MSVC 习惯）或 pch.h（跨平台常用），里面集中包含所有项目中高频、不变、不常修改的头
• 先单独编译它生成 PCH 文件：例如 MSVC 中设置该文件属性为“创建预编译头”；Clang/GCC 用 -x c++-header 参数
• 其余 .cpp 文件开头必须第一行是 #include "pch.h"（MSVC 要求严格；Clang/GCC 可配 -include pch.h 绕过位置限制）
• 编译器自动识别并复用已生成的 PCH：只要头内容或编译选项（如宏定义、语言标准）没变，就跳过重编译

哪些头适合放进 PCH？

目标是“高频率引入 + 极少改动”：

HISUI 前端框架开发指南（IRIS版）

HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库，专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考，支持声明式与编程式两种初始化方式，提供 $cm/$m 数据访问方法。

下载

• 标准库头：、、、 等
• 项目级公共头：Common.h、Platform.h（不含条件编译或频繁变更内容）
• 稳定的第三方 SDK 头（如 Qt 的 ，前提是版本固定）

避免放入：#define DEBUG 这类易变宏的头、模板实现头（如 impl.h）、依赖当前 .cpp 特定上下文的头——否则 PCH 失效或引发 ODR 错误。

注意事项和常见坑

PCH 加速明显，但配置不当反而拖慢或出错：

• 修改 PCH 内容后，所有依赖它的 .cpp 都要重新编译（因为 PCH 文件时间戳变了）
• 不同编译单元若用不同宏开关（如 #define _CRT_SECURE_NO_WARNINGS）包含同一 PCH，可能导致不一致行为
• MSVC 要求 PCH 必须是第一个 #include，且前面不能有任何代码/注释（包括空行）
• CMake 中启用 PCH 需显式调用 target_precompile_headers()（CMake 3.16+），旧版本需手动配置编译选项

基本上就这些。PCH 不复杂但容易忽略细节，用对了，大型项目的全量编译时间能减少 20%~50%。

C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！