What are precompiled headers?
Often C++ source files include headers from external libraries. In Windows you include windows.h
. These header files can be very large and they take some time to process. Each time you compile a C++ file the compiler has to read and process thousands of lines from these header files. But external libraries don't change and you can save a lot of time if you only process these files once and save the result.
A precompiled header is simply a bunch of header files that has been processed to an intermediate form that later can be used by the compiler again and again.
Precompiled headers in Visual C++
In Visual C++ it is customary to #include
all your non-changing header files in stdafx.h
. You then instruct the compiler to create the precompiled header stdafx.pch
while compiling stdafx.cpp
which does nothing but include stdafx.h
. If you want to use the precompiled header in another .cpp
file you have to include stdafx.h
as the first include file and the instruct the compiler to use stdafx.pch
for your precompiled header.
If you get an error about not including stdafx.h
you simply have to instruct the compiler to not use a precompiled header for that particular source file. (Or you can include stdafx.h
.)
Precompiled header settings for individual source files
Visual C++ allows you to control the compiler settings for the entire project and for individual files. To access individual properties you select the source file in the solution explorer, right click it and select Properties from the context menu. The options for precompiled headers are found at Configuration Properties => C/C++ => Precompiled Headers. If you modify these settings you will often want to do that for all configurations (e.g. Debug and Release).
When you are using precompiled headers you will have a setting for the entire project that instructs the compiler to use stdafx.pch
for the precompiled header. The stdafx.cpp
will have an individual settings that instructs the compiler to generate stdafx.pch
, and if you have some source files that doesn't include stdafx.h
you can set individual settings on these to not use precompiled headers.
与恶龙缠斗过久,自身亦成为恶龙;凝视深渊过久,深渊将回以凝视…