/Yu（使用预编译头文件）
更新：2007 年 11 月
指示编译器使用当前编译中现有的预编译头 (.pch) 文件。
/Yu[filename]
参数
- filename
头文件的名称，它包含在使用 #include 预处理器指令的源文件中。
备注
对于创建预编译头的 /Yc 选项和任何随后指示使用预编译头的 /Yu 选项，包含文件的名称必须相同。
对于 /Yc，filename 指定预编译停止的位置；编译器预编译直到 filename 的所有代码，并使用包含文件的基名称和 .pch 扩展名对得到的预编译头进行命名。
该 .pch 文件必须是使用 /Yc 创建的。
编译器将所有在 .h 文件之前出现的代码视为已经过预编译。它刚好跳到与 .h 文件关联的 #include 指令之外，使用 .pch 文件中包含的代码，然后编译 filename 之后的所有代码。
在命令行上，/Yu 和 filename 之间不允许存在空格。
如果指定 /Yu 选项但不带文件名，则源程序必须包含指定预编译头（.pch 文件）的文件名的 #pragma hdrstop 杂注。在这种情况下，编译器将使用由 /Fp（命名 .pch 文件） 命名的预编译头（.pch 文件）。编译器跳到该杂注所在的位置，从由杂注指定的预编译头文件还原编译状态，然后只编译杂注后面的代码。如果 #pragma hdrstop 没有指定文件名，编译器将查找其名称从扩展名为 .pch 的源文件的基名称派生的文件。还可以使用 /Fp 选项指定不同的 .pch 文件。
如果指定 /Yu 选项但不带文件名，且未能指定 hdrstop 杂注，则生成错误信息，且编译不成功。
如果 /Ycfilename 和 /Yufilename 选项出现在同一命令行上，并且引用同一文件名，则 /Ycfilename 优先，对直到命名文件（包含该文件）的所有代码进行预编译。此功能简化了生成文件的编写。
由于 .pch 文件包含的信息涉及计算机环境以及程序的内存地址，因此，只应在创建 pch 文件的计算机上使用该文件。
有关预编译头的更多信息，请参见：
在 Visual Studio 开发环境中设置此编译器选项
在项目中的 .cpp 文件中指定 /Yc（创建预编译头文件）。
打开此项目的“属性页”对话框。有关详细信息，请参见如何：打开项目属性页。
单击“C/C++”文件夹。
单击“预编译头”属性页。
修改“通过文件创建/使用 PCH”属性或“创建/使用预编译头”属性。
以编程方式设置此编译器选项
示例
如果下列代码：
#include <afxwin.h> // Include header for class library
#include "resource.h" // Include resource definitions
#include "myapp.h" // Include information specific to this app
...
使用命令行 CL /YuMYAPP.H PROG.CPP 进行编译，则编译器不处理这三个 include 语句，但使用 MYAPP.pch 中的预编译代码，从而节省了用于预处理所有这三个文件（以及它们可能包含的任何文件）的时间。
可以将 /Fp（命名 .pch 文件） 选项与 /Yu 选项一起使用，以指定 .pch 文件的名称（如果该名称不同于 /Yc 的文件名参数或源文件的基名称），如下所示：
CL /YuMYAPP.H /FpMYPCH.pch PROG.CPP
此命令指定名为 MYPCH.pch 的预编译头文件。编译器使用其内容还原直到 MYAPP.h（包含该文件）的所有头文件的预编译状态。然后编译器编译在 MYAPP.h include语句之后出现的代码。