预编译头(PCH)通过预先编译高频、稳定、通用的头文件(如、、”Common.h”)为二进制格式,显著提升C++编译速度;需避免频繁修改、含特化模板或条件编译不一致的头;MSVC和Clang/GCC启用方式不同但逻辑一致,配置得当可降编译时间20%~50%。

预编译头(Precompiled Header,PCH)是 C++ 工程中提升编译速度的经典手段,核心思路是把稳定、庞大、几乎每个源文件都包含的头文件(比如 、、 或项目级公共头)预先编译成二进制中间格式,后续编译单元直接复用,跳过重复的词法分析、语法解析和模板实例化等开销。
哪些头适合放进 PCH?
不是所有头都该进 PCH。关键看三点:是否高频包含、是否内容稳定、是否不常修改。
✅ 推荐:标准库头(、)、平台 SDK 头()、项目通用宏/类型定义头("Common.h") ❌ 避免:频繁修改的头、含内联函数/模板定义且被特化使用的头(可能引发 ODR 违规)、带条件编译且各源文件宏定义不一致的头 ⚠️ 注意:PCH 文件本身一旦变化(如增删头、改宏),所有依赖它的 .cpp 都要重编译——所以它应是“低频变更”的锚点
主流编译器怎么启用 PCH?
不同工具链写法略有差异,但逻辑一致:先生成一个 PCH 文件,再让其他源文件引用它。
MSVC(Visual Studio):
① 新建 StdAfx.h(或任意名),在里面 #include 所有想预编译的头;
② 对应建 StdAfx.cpp,只写 #include "StdAfx.h";
③ 右键该 .cpp → 属性 → C/C++ → 预编译头 → 设为“创建预编译头”;
④ 其他 .cpp 文件顶部第一行必须是 #include "StdAfx.h",且属性设为“使用预编译头” Clang/GCC:
① 编译头文件:clang++ -x c++-header stdafx.h -o stdafx.pch;
② 编译源文件时加:clang++ -include stdafx.h -Xclang -include-pch -Xclang stdafx.pch main.cpp;
GCC 类似,用 -include 和 -Winvalid-pch(可选)校验
实用技巧与避坑点
PCH 不是“开箱即用就快”,配置不当反而拖慢或引发奇怪错误。
立即学习“C++免费学习笔记(深入)”;
确保 PCH 包含顺序正确:PCH 中的头不能依赖后面才定义的宏或类型;所有 .cpp 必须以 #include "xxx.h" 开头(MSVC 要求严格) 避免在 PCH 里用 #pragma once 或 include guard 控制粒度——PCH 本身就是整体编译单元,细粒度控制无意义 调试时可临时禁用 PCH(VS 中设为“不使用预编译头”),快速验证是否是 PCH 引发的编译错误或符号问题 大型项目建议分层 PCH:基础层(STL + OS)、中间层(框架头)、应用层(业务公共头),按需组合,避免“一锅炖”导致更新太重
基本上就这些。PCH 是工程优化中性价比很高的一步,尤其对 Windows 下传统 MFC/Win32 项目或含大量模板的标准库使用的项目效果显著。不复杂但容易忽略细节,配好后全量编译时间常能下降 20%~50%。
以上就是C++中的预编译头(PCH)怎么用?加快C++项目编译速度技巧【工程优化】的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1489207.html
微信扫一扫
支付宝扫一扫