第二篇：工业级 C++/Qt 项目预编译头（PCH）完整配置指南：从 0 到 1 部署，编译速度提升 80%

前言

大型 Qt 项目的编译速度往往是开发效率的瓶颈：修改一个业务文件，要等几分钟才能看到结果。预编译头（PCH）技术可以将几乎不修改的系统库、Qt 库提前编译成二进制缓存，让后续编译直接复用，通常能将编译速度提升 30%~80%。

本文将结合工业级项目规范，从零开始讲解预编译头的完整配置流程，同时提供老项目快速部署的批量方案，帮你无痛改造现有项目。

一、预编译头的核心原理与适用场景

什么是预编译头？

预编译头（PCH）是 VS 的一种编译优化技术，它将项目中永远不会修改的头文件（如 STL、Qt 库、第三方 SDK）提前编译成一个.pch二进制文件。后续编译时，编译器直接加载这个缓存文件，不用每次都重新解析成千上万行的头文件代码。

哪些文件能放进 PCH？

✅ 推荐放入：

• STL 标准库（iostream、string、vector等）
• Qt 模块总头（QtCore、QtGui、QtWidgets等）
• 永远不变的第三方库（如 Halcon、OpenCV 的稳定头文件）

❌ 绝对禁止放入：

• 你自己写的业务头文件
• 经常修改的配置头文件
• Qt 自动生成的ui_*.h、moc_*.h
• 可能存在宏冲突的头文件（如winsock.h）

二、从零开始的预编译头完整配置流程

步骤 1：创建两个核心文件

在项目根目录新建两个文件：

1. pch.h（预编译头文件，存放不变的库头）
2. pch.cpp