C++预编译头文件

参考一：

许多初学 VC 的朋友也许都为那么一个问题困扰过：

    为什么所有的 cpp 都必须 #include "stdafx.h"

    也许请教了别的高手之后，他们会告诉你，这是预编译头，必须包含。可是，这到底
是为什么呢？预编译头有什么用呢？

    这得从头文件的编译原理讲起。其实头文件并不神秘，它的全部作用，就是把自己的
所有内容直接“粘贴”到相应的 #include 语句处。如果不相信的话，不妨做个实验，将
一个 cpp 中的所有 #include 语句删掉，并将它包含的文件粘贴到相应的位置，你会发
现，文件的编译和运行都完全没有受到影响。其实，编译器在编译你的程序的时候，所做
的第一件事，也就是展开所有的 #include 语句和 #define 语句。

    头文件的出现，固然给书写程序带来了很大方便。可是到了 Windows 时代后，慢慢
就呈现出一些问题了。几乎所有的 Windows 程序都必须包含 windows.h，而那个文件却
硕大无比，将它展开后往所有文件中一粘贴，编译的时候立刻慢得像只蜗牛。

    到了 MFC 时代后，情况更为恶劣了。毕竟 C 风格的 Windows 头文件里面包含的还
仅仅是函数定义和宏，编译难度不算太大，而 MFC 库里面的头文件可都是类声明啊！更
何况，一个最简单的工程，都会生成大量的类，需要用到大量的函数。如果工程稍微复杂
一些，编译难度可想而知！

    但是，人们惊奇地发现，虽然用到的头文件又多又杂，但是在一个工程中，总有那么
一堆头文件，是几乎所有 cpp 都必须包含的。那么，可不可以把这些头文件提取出来，
只编译一编，然后所有其它 cpp 就都能使用呢？没错，这就是预编译头的思想都由来！

    实践证明，使用了预编译头技术后，编译速度大大提高了。可以到你的工程目录下的
Debug 或 Release 目录中看一看，里面有一个体积极为硕大的 .pch 文件，那就是传说
中的“编译之后的预编译头”。

    使用了预编译头技术后，虽然带来了极大地方便，但也造成了一个问题：由于它假定
预编译头中包含过的头文件会在所有 cpp 中使用，因此它在编译你的 cpp 的时候，就会
将预编译头中已经编译完的部分加载到内存中。如果它突然发现你的 cpp 居然没有包含
预编译头，它就会很郁闷，因为它不知道该如何将已编译完的部分从内存中请出去，整个
编译过程就会失败。

    因此，如果你使用了预编译头技术，就必须在所有的 cpp 中包含预编译头。MFC 工
程中为你建立了一个默认的预编译头 stdafx.h，如果你愿意，也可以在自己的工程中使
用其它文件名作为你的预编译头，如果你觉得有必要。
 

 

预编译头文件的使用  
关键字：预编译，/Yu，/Yc，/Yx
本文介绍VC6的预编译功能的使用，由于预编译详细使用比较的复杂，这里只介绍几个最重要的预编译指令: /Yu, /Yc,/Yx,/Fp。其它的详细资料可以参考:
      MSDN->Visual Studio D6.0Document -> Visual C++6.0 Document
         ->VC++ Programmer Guider ->Compiler and Linker
         ->Details->Creating Precompiled Header files

预编译头的概念： 
所谓的预编译头就是把一个工程中的那一部分代码,预先编译好放在一个文件里(通常是以.pch为扩展名的)，这个文件就称为预编译头文件这些预先编译好的代码可以是任何的C/C++代码--------甚至是inline的函数，但是必须是稳定的，在工程开发的过程中不会被经常改变。如果这些代码被修改，则需要重新编译生成预编译头文件。注意生成预编译头文件是很耗时间的。同时你得注意预编译头文件通常很大，通常有6-7M大。注意及时清理那些没有用的预编译头文件。
也许你会问：现在的编译器都有Time stamp的功能，编译器在编译整个工程的时候，它只会编译那些经过修改的文件，而不会去编译那些从上次编译过，到现在没有被修改过的文件。那么为什么还要预编译头文件呢？答案在这里，我们知道编译器是以文件为单位编译的，一个文件经过修改后，会重新编译整个文件，当然在这个文件里包含的所有头文件中的东西（.eg Macro, Preprocessor ）都要重新处理一遍。VC的预编译头文件保存的正是这部分信息。以避免每次都要重新处理这些头文件。
预编译头的作用：
方法一：手动方法 
根据上文介绍，预编译头文件的作用当然就是提高便宜速度了，有了它你没有必要每次都编译那些不需要经常改变的代码。编译性能当然就提高了。
预编译头的使用：
     要使用预编译头，我们必须指定一个头文件，这个头文件包含我们不会经常改变的代码和其他的头文件，然后我们用这个头文件来生成一个预编译头文件（.pch文件）
 想必大家都知道 StdAfx.h这个文件。很多人都认为这是VC提供的一个“系统级别”的，编译器带的一个头文件。其实不是的，这个文件可以是任何名字的。我们来考察一个典型的由AppWizard生成的MFC Dialog Based　程序的预编译头文件。（因为AppWizard会为我们指定好如何使用预编译头文件，默认的是StdAfx.h，这是VC起的名字）。我们会发现这个头文件里包含了以下的头文件：
#include <afxwin.h>         // MFC core and standard components
#include <afxext.h>         // MFC extensions
#include <afxdisp.h>        // MFC Automation classes
#include <afxdtctl.h>             // MFC support for Internet Explorer 4 Common Controls
#include <afxcmn.h>     
这些正是使用MFC的必须包含的头文件，当然我们不太可能在我们的工程中修改这些头文件的，所以说他们是稳定的。
那么我们如何指定它来生成预编译头文件。我们知道一个头文件是不能编译的。所以我们还需要一个cpp文件来生成.pch 文件。这个文件默认的就是StdAfx.cpp。在这个文件里只有一句代码就是：#include “Stdafx.h”。原因是理所当然的，我们仅仅是要它能够编译而已―――也就是说，要的只是它的.cpp的扩展名。我们可以用/Yc编译开关来指定StdAfx.cpp来生成一个.pch文件，通过/Fp编译开关来指定生成的pch文件的名字。打开project ->Setting->C/C++ 对话框。把Category指向Precompiled Header。在左边的树形视图里选择整个工程　（如图）
（图１）
在图中我们的Project Options(右下角的那个白的地方)可以看到 /Fp “debug/PCH.pch”，这就是指定生成的.pch文件的名字，默认的通常是　<工程名>.pch（我的示例工程名就是PCH）。
然后，在左边的树形视图里选择StdAfx.cpp.如图：(图２)
这时原来的Project Option变成了 Source File Option（原来是工程，现在是一个文件，当然变了）。在这里我们可以看到 /Yc开关，/Yc的作用就是指定这个文件来创建一个Pch文件。/Yc后面的文件名是那个包含了稳定代码的头文件，一个工程里只能有一个文件的可以有YC开关。VC就根据这个选项把 StdAfx.cpp编译成一个Obj文件和一个PCH文件。
   然后我们再选择一个其它的文件来看看，如图：
在这里，Precomplier 选择了 Use ………一项，头文件是我们指定创建PCH 文件的stdafx.h
文件。事实上，这里是使用工程里的设置，（如图1）/Yu”stdafx.h”。
   这样，我们就设置好了预编译头文件。也就是说，我们可以使用预编译头功能了。以下是注意事项：
1):如果使用了/Yu，就是说使用了预编译，我们在每个.cpp文件的最开头，我强调一遍是最开头，包含 你指定产生pch文件的.h文件（默认是stdafx.h）不然就会有问题。如果你没有包含这个文件，就告诉你Unexpected file end. 如果你不是在最开头包含的，你自己试以下就知道了，绝对有很惊人的效果…..
2）如果你把pch文件不小心丢了，根据以上的分析，你只要让编译器生成一个pch文件就可以了。也就是说把 stdafx.cpp（即指定/Yc的那个cpp文件）从新编译一遍就可以了。当然你可以傻傻的 Rebuild all。简单一点就是选择那个cpp文件，按一下Ctrl + F7就可以了。
方法二。自动使用 
很简单只要指定/YX就可以了。或者在上图中选择Automatic………就可以了。注意的事情是如果你指定了/Yc /Yu的话，/Yx是会被忽略的。前者的优先级别高一些。

参考二：

预编译头文件

 在编写程序的时候，有一些头文件被许多文件用到。例如：windows.h这样的系统头文件。如果不采用预编译头文件，那么每个包含windows.h的文件都需要编译这个文件。这将会增加编译时间。正是为了解决这个问题，Microsoft Visual C++提出了预编译头文件的解决方法。

  所谓预编译头文件，即将一些指定的头文件预先编译成二进制文件，为了与其他二进制文件区别开来。预编译的头文件生成的二进制文件以.PCH结尾。在Visual C++中默认使用预编译头文件，预编译头文件默认为stdafx.cpp,将那些常用的头文件都放进stdafx.h中去即可。而stdafx.cpp则只包含stdafx.h一个文件。其他所有文件都默认为调用预编译头文件，也即每个.cpp文件都需要在第一行包括#include "stdafx.h"这样的文件。
     当然我们也可以自己定义预编译头文件。例如创建这样两个文件：MyStdafx.h,MyStdafx.cpp。然后将需要提前编译的头文件包含在MyStdafx.h中去，并将MyStdafx.h包含到MyStdafx.cpp中去。将通过Properties\C/C++\Precompiled Header中选择Create Precomliled Header即可。

  Visual C++的其他文件都是默认使用预编译头文件的，并且默认指定了使用的预编译头文件stdafx.h,所以我们在使用了预编译头文件的.cpp文件中必须首行包含stdafx.h。当然我们如果不想使用stdafx.h的话，可以通过Properties\C/C++\Precompiled Header中设置Not Using Precompiled Headers。如此设置，即可以不包含stdafx.h文件了。

  当设定好了预编译头文件时，我们来看一下它是如何工作的。编译都是以.cpp文件为单位开始的，当编译器发现有包括预编译头文件stdafx.h时，并不是将这个文件通过预编译包含进来，而是代替以相就的.pch文件。这样将大大节约编译时间。

  编译链接过程

当一段代码写好之后进行Build时，主要完成以下三个步骤。
1.  预处理阶段：即由预处理器对预处理指令（＃include、#define和#if）进行处理，在内存中输出翻译单元（一种临时文件）。还有预编译头文件并生成pch文件。
2.  编译阶段：编译器将内存中的预处理单元，及.pch文件，并编译.cpp文件成生对应的二进制.obj文件（里面包含的是程序的相对地址）。
3.  链接阶段：链接器将所有obj文件以及所用到的标准库链接成可执行文件.exe。

参考三：

预编译头文件

今天在改一个很大的程序，慢慢看，慢慢改。突然发现一个.c文件，里面什么也没有，

就几个头文件，我一看，我靠，这不是把简单的问题搞复杂了吗，随手删掉那个c文件。

结果不能编译了，我靠：

fatal error C1083: Cannot open precompiled header file: \'Debug/v13_3.pch\':

No such file or directory

怎么rebuild all都不行。

上网查了一下，才搞懂了：

－－－－－－－－－－－－－－－－总结－－－－－－

如果工程很大，头文件很多，而有几个头文件又是经常要用的，那么

1。把这些头文件全部写到一个头文件里面去，比如写到preh.h

2。写一个preh.c，里面只一句话：#include "preh.h"

3。对于preh.c，在project setting里面设置creat precompiled headers，对于其他

.c文件，设置use precompiled header file

//

哈哈

我试了一下，效果很明显，不用precompiled header，编译一次我可以去上个厕所，用

precompiled header，编译的时候，我可以站起来伸个懒腰，活动活动就差不多啦

－－－－－－－－－转载的文章－－－－－－－－－－

预编译头的概念：

所谓的预编译头就是把一个工程中的那一部分代码,预先编译好放在一个文件里(通常是

以.pch为扩展名的)，这个文件就称为预编译头文件这些预先编译好的代码可以是任何的

C/C++代码--------甚至是inline的函数，但是必须是稳定的，在工程开发的过程中不会

被经常改变。如果这些代码被修改，则需要重新编译生成预编译头文件。注意生成预编

译头文件是很耗时间的。同时你得注意预编译头文件通常很大，通常有6-7M大。注意及

时清理那些没有用的预编译头文件。

也许你会问：现在的编译器都有Time stamp的功能，编译器在编译整个工程的时候，它

只会编译那些经过修改的文件，而不会去编译那些从上次编译过，到现在没有被修改过

的文件。那么为什么还要预编译头文件呢？答案在这里，我们知道编译器是以文件为单

位编译的，一个文件经过修改后，会重新编译整个文件，当然在这个文件里包含的所有

头文件中的东西（.eg Macro, Preprocesser ）都要重新处理一遍。VC的预编译头文件

保存的正是这部分信息。以避免每次都要重新处理这些头文件。

预编译头的作用：

根据上文介绍，预编译头文件的作用当然就是提高便宜速度了，有了它你没有必要每次

都编译那些不需要经常改变的代码。编译性能当然就提高了。

预编译头的使用：

要使用预编译头，我们必须指定一个头文件，这个头文件包含我们不会经常改变的

代码和其他的头文件，然后我们用这个头文件来生成一个预编译头文件（.pch文件）

想必大家都知道 StdAfx.h这个文件。很多人都认为这是VC提供的一个“系统级别”的

，编译器带的一个头文件。其实不是的，这个文件可以是任何名字的。我们来考察一个

典型的由AppWizard生成的MFC Dialog Based　程序的预编译头文件。（因为AppWizard

会为我们指定好如何使用预编译头文件，默认的是StdAfx.h，这是VC起的名字）。我们

会发现这个头文件里包含了以下的头文件：

#include <afxwin.h> // MFC core and standard components

#include <afxext.h> // MFC extensions

#include <afxdisp.h> // MFC Automation classes

#include <afxdtctl.h> // MFC support for Internet Explorer 4

Common Controls

#include <afxcmn.h>

这些正是使用MFC的必须包含的头文件，当然我们不太可能在我们的工程中修改这些头文

件的，所以说他们是稳定的。

那么我们如何指定它来生成预编译头文件。我们知道一个头文件是不能编译的。所以我

们还需要一个cpp文件来生成.pch 文件。这个文件默认的就是StdAfx.cpp。在这个文件

里只有一句代码就是：#include “Stdafx.h”。原因是理所当然的，我们仅仅是要它能

够编译而已?D?D?D也就是说，要的只是它的.cpp的扩展名。我们可以用/Yc编译开关来指

定StdAfx.cpp来生成一个.pch文件，通过/Fp编译开关来指定生成的pch文件的名字。打

开project ->Setting->C/C++ 对话框。把Category指向Precompiled Header。在左边的

树形视图里选择整个工程　

Project Options(右下角的那个白的地方)可以看到 /Fp “debug/PCH.pch”，这就是指

定生成的.pch文件的名字，默认的通常是　<工程名>.pch（我的示例工程名就是PCH）。

然后，在左边的树形视图里选择StdAfx.cpp.//这时只能选一个cpp文件！

这时原来的Project Option变成了 Source File Option（原来是工程，现在是一个文件

，当然变了）。在这里我们可以看到 /Yc开关，/Yc的作用就是指定这个文件来创建一个

Pch文件。/Yc后面的文件名是那个包含了稳定代码的头文件，一个工程里只能有一个文

件的可以有YC开关。VC就根据这个选项把 StdAfx.cpp编译成一个Obj文件和一个PCH文件

。

然后我们再选择一个其它的文件来看看，//其他cpp文件

在这里，Precomplier 选择了 Use &8943;&8943;&8943;一项，头文件是我们指定创建PCH 文件的stda

fx.h

文件。事实上，这里是使用工程里的设置，（如图1）/Yu”stdafx.h”。

这样，我们就设置好了预编译头文件。也就是说，我们可以使用预编译头功能了。以

下是注意事项：

1):如果使用了/Yu，就是说使用了预编译，我们在每个.cpp文件的最开头，我强调一遍

是最开头，包含 你指定产生pch文件的.h文件（默认是stdafx.h）不然就会有问题。如

果你没有包含这个文件，就告诉你Unexpected file end. 如果你不是在最开头包含的，

你自己试以下就知道了，绝对有很惊人的效果&8943;..

fatal error C1010: unexpected end of file while looking for precompiled

header directive

Generating Code...

2）如果你把pch文件不小心丢了，编译的时候就会产生很多的不正常的行为。根据以上

的分析，你只要让编译器生成一个pch文件。也就是说把 stdafx.cpp（即指定/Yc的那个

cpp文件）从新编译一遍。当然你可以傻傻的 Rebuild All。简单一点就是选择那个cpp

文件，按一下Ctrl + F7就可以了。不然可是很浪费时间的。

 

 

例如：

加了一个对话框类文件，重新编译后出现编译错误： 
d:\center\lkdraw\codlg.cpp(4)   :   fatal   error   C1083:   Cannot   open   precompiled   header   file:   'Debug/LkDraw.pch':   No   such   file   or   directory 
codlg.cpp   (4)行是如下语句：#include   "stdafx.h" 
但我的stdafx.h   文件明明在，而且其它的对话框文件一样的写法却没错误。 
请问如何解决？ 

在菜单project-settings-c/c++   中的Project   Options   中把/Fp"Debug/LkDraw.pch"删掉，成功搞定。