미리 컴파일된 헤더 파일

아티클
10/12/2023

Visual Studio 에서 새 프로젝트를 만들면 미리 컴파일된 헤더 파일이pch.h 프로젝트에 추가됩니다. (Visual Studio 2017 및 이전 버전에서는 파일이 호출 stdafx.h되었습니다.) 파일의 목적은 빌드 프로세스의 속도를 높이기 위한 것입니다. 모든 안정적인 헤더 파일(예: <vector>와 같은 표준 라이브러리 헤더)은 여기에 포함되어야 합니다. 미리 컴파일된 헤더는 이 헤더나 이 헤더가 포함하는 모든 파일이 수정될 때만 컴파일됩니다. 프로젝트 소스 코드를 변경하는 경우에만 빌드가 미리 컴파일된 헤더에 대한 컴파일을 건너뜁니다.

미리 컴파일된 헤더에 대한 컴파일러 옵션은 다음과 같습니다 /Y. 프로젝트 속성 페이지에서 옵션은 구성 속성>C/C++>미리 컴파일된 헤더 아래에 있습니다. 미리 컴파일된 헤더를 사용하지 않도록 선택하고, 헤더 파일 이름과 출력 파일의 이름 및 경로를 지정할 수 있습니다.

미리 컴파일된 사용자 지정 코드

빌드하는 데 상당한 시간이 걸리는 큰 프로젝트의 경우 미리 컴파일된 사용자 지정 파일을 만드는 것이 좋습니다. Microsoft C 및 C++ 컴파일러는 인라인 코드를 포함하여 모든 C 또는 C++ 코드를 미리 컴파일하는 옵션을 제공합니다. 이 성능 기능을 사용하여 안정적인 코드 본문을 컴파일하고, 컴파일된 코드 상태를 파일에 저장하고, 후속 컴파일 중에 미리 컴파일된 코드를 아직 개발 중인 코드와 결합할 수 있습니다. 안정적인 코드를 다시 컴파일할 필요가 없으므로 나중에 컴파일할 때마다 더 빠릅니다.

소스 코드를 미리 컴파일해야 하는 경우

미리 컴파일된 코드는 개발 주기 동안 컴파일 시간을 단축하는 데 유용합니다. 특히 다음과 같은 경우에 유용합니다.

자주 변경되지 않는 코드의 본문 중 대부분을 항상 사용하는 경우.
프로그램은 여러 모듈로 구성되며, 이 모든 모듈은 포함 파일 표준 집합 및 동일한 컴파일 옵션을 사용합니다. 이 경우 모든 포함 파일을 미리 컴파일된 하나의 헤더로 미리 컴파일할 수 있습니다. 포함 파일을 처리하는 새로운 방법에 대한 자세한 내용은 헤더 단위, 모듈 및 미리 컴파일된 헤더 비교를 참조하세요.

첫 번째 컴파일(미리 컴파일된 헤더 파일을 만드는 컴파일)은 후속 컴파일보다 약간 더 오래 걸립니다. 후속 컴파일은 미리 컴파일된 코드를 포함함으로써 더 빠르게 진행될 수 있습니다.

C와 C++ 프로그램을 모두 미리 컴파일할 수 있습니다. C++ 프로그래밍에서는 클래스 인터페이스 정보를 헤더 파일로 구분하는 것이 일반적입니다. 이 헤더 파일은 나중에 클래스를 사용하는 프로그램에 포함될 수 있습니다. 이 헤더를 미리 컴파일하면 프로그램이 컴파일하는 데 걸리는 시간을 줄일 수 있습니다.

참고 항목

소스 파일당 미리 컴파일된 헤더(.pch) 파일 하나만 사용할 수 있지만 프로젝트에서 여러 .pch 파일을 사용할 수 있습니다.

코드를 미리 컴파일하기 위한 두 가지 선택 사항

C 또는 C++ 코드를 미리 컴파일할 수 있습니다. 헤더 파일만 미리 컴파일하는 것으로 제한되지 않습니다.

미리 컴파일하려면 계획이 필요하지만 간단한 헤더 파일 이외의 소스 코드를 미리 컴파일하는 경우 컴파일 속도가 훨씬 빨라집니다.

소스 파일이 공통 헤더 파일 집합을 사용하거나 소스 코드를 미리 컴파일에 포함하려는 경우 코드를 미리 컴파일합니다.

미리 컴파일된 헤더 옵션은 (미리 컴파일된 헤더 파일 만들기) 및 (미리 컴파일된 헤더 파일 사용)입니다 /Yc ./Yu 미리 컴파일된 헤더를 만드는 데 사용합니다 /Yc . 선택적 hdrstop pragma /Yc 와 함께 사용하면 헤더 파일과 소스 코드를 모두 미리 컴파일할 수 있습니다. 기존 컴파일에서 미리 컴파일된 기존 헤더를 사용하려면 선택합니다 /Yu . 미리 컴파일된 헤더에 /Yc 대한 대체 이름을 제공하기 위해 옵션과 /Yu 함께 사용할 /Fp 수도 있습니다.

컴파일러 옵션 참조 문서는 /Yu/Yc 개발 환경에서 이 기능에 액세스하는 방법을 설명합니다.

미리 컴파일된 헤더 일관성 규칙

PCH 파일에는 컴퓨터 환경에 대한 정보 및 프로그램에 대한 메모리 주소 정보가 포함되어 있으므로 PCH 파일을 만든 컴퓨터에서만 사용해야 합니다.

미리 컴파일된 헤더의 파일별 사용에 대한 일관성 규칙

/Yu 컴파일러 옵션을 사용하면 사용할 PCH 파일을 지정할 수 있습니다.

PCH 파일을 사용하는 경우 컴파일러는 달리 지정하지 않는 한 PCH 파일을 만들 때 적용된 것과 동일한 컴파일 환경을 가정합니다. 컴파일 환경에는 컴파일러 옵션, pragma 등이 포함됩니다. 불일치가 검색되면 컴파일러는 경고를 표시하고 가능한 경우 불일치를 식별합니다. 반드시 이러한 경고가 PCH 파일에 문제가 있음을 나타내는 것은 아니며 단지 있을 수 있는 충돌을 경고할 뿐입니다. PCH 파일의 일관성 요구 사항은 다음 섹션에 설명되어 있습니다.

컴파일러 옵션 일관성

다음 컴파일러 옵션은 PCH 파일을 사용할 때 불일치 경고를 트리거할 수 있습니다.

전처리기(/D) 옵션을 사용하여 만든 매크로는 PCH 파일을 만든 컴파일과 현재 컴파일 간에 동일해야 합니다. 정의된 상수의 상태는 검사 않지만 이러한 매크로가 변경되면 예측할 수 없는 결과가 발생할 수 있습니다.
PCH 파일은 및 /EP 옵션에서 /E 작동하지 않습니다.
PCH 파일을 사용하는 후속 컴파일에서 이러한 옵션을 사용하려면 먼저 찾아보기 정보 생성(/FR) 옵션 또는 지역 변수 제외(/Fr) 옵션을 사용하여 PCH 파일을 만들어야 합니다.

C 7.0 호환(`/Z7`)

PCH 파일을 만들 때 이 옵션이 적용되는 경우 나중에 PCH 파일을 사용하는 컴파일에서 디버깅 정보를 사용할 수 있습니다.

PCH 파일을 만들 때 C 7.0 호환(/Z7) 옵션이 적용되지 않으면 나중에 PCH 파일을 /Z7 사용하고 경고를 트리거하는 컴파일이 수행됩니다. 디버깅 정보는 현재 .obj 파일에 배치되며 PCH 파일에 정의된 로컬 기호는 디버거에서 사용할 수 없습니다.

경로 일관성 포함

PCH 파일에는 헤더를 만들 때 적용된 포함 경로에 대한 정보가 포함되어 있지 않습니다. PCH 파일을 사용하는 경우 컴파일러는 항상 현재 컴파일에 지정된 헤더 포함 경로를 사용합니다.

원본 파일 일관성

미리 컴파일된 헤더 파일/Yu() 사용 옵션을 지정하면 컴파일러는 미리 컴파일될 소스 코드에 표시되는 모든 전처리기 지시문(pragmas 포함)을 무시합니다. 이러한 전처리기 지시문에 지정된 컴파일은 미리 컴파일된 헤더 파일 만들기(/Yc) 옵션에 사용되는 컴파일과 동일해야 합니다.

Pragma 일관성

PCH 파일을 만드는 동안 처리되는 Pragmas는 일반적으로 PCH 파일이 나중에 사용되는 파일에 영향을 줍니다. comment 및 message pragma는 컴파일의 re기본der에 영향을 주지 않습니다.

이러한 pragma는 PCH 파일 내의 코드에만 영향을 줍니다. 나중에 PCH 파일을 사용하는 코드에는 영향을 주지 않습니다.

comment
linesize

message
page

pagesize
skip

subtitle
title

이러한 pragma는 미리 컴파일된 헤더의 일부로 유지되며 미리 컴파일된 헤더를 사용하는 컴파일의 나머지 부분에 영향을 줍니다.

alloc_text
auto_inline
check_stack
code_seg
data_seg

function
include_alias
init_seg
inline_depth

inline_recursion
intrinsic
optimize
pack

pointers_to_members
setlocale
vtordisp
warning

/Yc 및 /Yu에 대한 일관성 규칙

사용하거나 /Yu사용하여 미리 /Yc 컴파일된 헤더를 사용하는 경우 컴파일러는 현재 컴파일 환경을 PCH 파일을 만들 때 존재했던 것과 비교합니다. 현재 컴파일에 대해 (일관된 컴파일러 옵션, pragma 등을 사용하여) 이전 이름과 일치하는 환경을 지정해야 합니다. 불일치가 검색되면 컴파일러는 경고를 표시하고 가능한 경우 불일치를 식별합니다. 반드시 이러한 경고가 PCH 파일에 문제가 있음을 나타내는 것은 아니며 단지 있을 수 있는 충돌을 경고할 뿐입니다. 다음 섹션에서는 미리 컴파일된 헤더의 일관성 요구 사항에 대해 설명 합니다.

컴파일러 옵션 일관성

다음 표에는 미리 컴파일된 헤더를 사용할 때 불일치 경고를 트리거할 수 있는 컴파일러 옵션이 나열되어 있습니다.

옵션	이름	규칙
`/D`	상수와 매크로를 정의합니다.	미리 컴파일된 헤더를 만든 컴파일과 현재 컴파일 간에 동일해야 합니다. 정의된 상수의 상태는 검사 않습니다. 그러나 파일이 변경된 상수의 값에 의존하는 경우 예측할 수 없는 결과가 발생할 수 있습니다.
`/E` 또는 `/EP`	전처리기 출력을 표준 출력에 복사	미리 컴파일된 헤더는 해당 또는 `/EP` 옵션에서 `/E` 작동하지 않습니다.
`/Fr` 또는 `/FR`	Microsoft 소스 브라우저 정보 생성	옵션과 `/Fr``/FR` 옵션이 유효 `/Yu` 하려면 미리 컴파일된 헤더를 만들 때도 해당 옵션이 적용되어 있어야 합니다. 미리 컴파일된 헤더를 사용하는 후속 컴파일 역시 소스 브라우저 정보를 생성합니다. 브라우저 정보는 단일 `.sbr` 파일에 배치되며 CodeView 정보와 동일한 방식으로 다른 파일에서 참조됩니다. 원본 브라우저 정보의 배치를 재정의할 수 없습니다.
`/GA`, `/GD`, `/GE`, `/Gw` 또는 `/GW`	Windows 프로토콜 옵션	미리 컴파일된 헤더를 만든 컴파일과 현재 컴파일 간에 동일해야 합니다. 이러한 옵션이 다른 경우 컴파일러에서 경고를 내보낸다.
`/Zi`	완전한 디버깅 정보 생성	미리 컴파일된 헤더를 만들 때 이 옵션이 적용되는 경우 미리 컴파일을 사용하는 후속 컴파일에서 디버깅 정보를 사용할 수 있습니다. `/Zi` 미리 컴파일된 헤더를 만들 때 적용되지 않으면 미리 컴파일을 사용하는 후속 컴파일과 `/Zi` 옵션이 경고를 트리거합니다. 디버깅 정보는 현재 개체 파일에 배치되며 미리 컴파일된 헤더에 정의된 로컬 기호는 디버거에서 사용할 수 없습니다.

참고 항목

미리 컴파일된 헤더 기능은 C 및 C++ 소스 파일에서만 사용하도록 만들어졌습니다.

프로젝트에서 미리 컴파일된 헤더 사용

이전 섹션에서는 미리 컴파일된 헤더, 즉 /Yc 및 /Yu, /Fp 옵션, hdrstop pragma에 대한 개요를 제공합니다. 이 섹션에서는 프로젝트에서 미리 컴파일된 수동 헤더 옵션을 사용하는 방법에 대해 설명합니다. 또한 예제 메이크파일과 이 메이크파일이 관리하는 코드로 끝납니다.

프로젝트에서 수동 미리 컴파일된 헤더 옵션을 사용하는 또 다른 방법은 Visual Studio의 기본 설정 중에 생성된 디렉터리에 있는 MFC\SRC 메이크파일 중 하나를 연구합니다. 이러한 메이크파일은 이 섹션에 제시된 것과 비슷한 접근 방식을 취합니다. NMAKE(Microsoft Program Maintenance Utility) 매크로를 더 많이 사용하고 빌드 프로세스를 보다 세부 제어할 수 있습니다.

빌드 프로세스의 PCH 파일

소프트웨어 프로젝트의 코드 베이스는 종종 여러 C 또는 C++ 원본 파일, 개체 파일, 라이브러리 및 헤더 파일에 포함됩니다. 일반적으로 메이크파일은 이러한 요소의 조합을 실행 파일로 조정합니다. 다음 그림은 미리 컴파일된 헤더 파일을 사용하는 메이크파일의 구조를 나타낸 것입니다. 이 다이어그램의 NMAKE 매크로 이름과 파일 이름은 PCH용 샘플 메이크파일 및 PCH의 예제 코드에 있는 예제 코드와 일치합니다.

이 그림에서는 세 개의 도식적인 디바이스를 사용하여 빌드 프로세스의 흐름을 보여줍니다. 명명된 사각형은 각 파일이나 매크로를 나타내고, 세 개의 매크로는 하나 이상의 파일을 나타냅니다. 음영 처리된 영역은 각 컴파일 또는 링크 작업을 나타냅니다. 화살표는 컴파일 또는 연결 프로세스 중에 어떤 파일과 매크로가 결합되는지 보여줍니다.

The diagram is described in the text following the diagram.
미리 컴파일된 헤더 파일을 사용하는 메이크파일의 구조:

Diagram showing example inputs and outputs of a makefile that uses a precompiled header file.

다이어그램 STABLEHDRSBOUNDRY 맨 위에서 시작하여 파일을 다시 컴파일할 필요가 없는 NMAKE 매크로입니다. 이러한 파일은 미리 컴파일된 헤더 파일(STABLE.pch)이

CL /c /W3 /Yc$(BOUNDRY) applib.cpp myapp.cpp

미리 컴파일된 헤더 파일(STABLE.pch)이 없거나 두 매크로에 나열된 파일을 변경하는 경우에만 해당합니다. 두 경우 모두 미리 컴파일된 헤더 파일에는 매크로에 나열된 STABLEHDRS 파일의 코드만 포함됩니다. 매크로에서 미리 컴파일 BOUNDRY 할 마지막 파일을 나열합니다.

이러한 매크로에 나열하는 파일은 헤더 파일이나 C 또는 C++ 원본 파일일 수 있습니다. (단일 PCH 파일은 C 및 C++ 원본 모두에서 사용할 수 없습니다.) 매크로를 사용하여 파일 내의 hdrstop 특정 지점에서 미리 컴파일을 중지할 BOUNDRY 수 있습니다. 자세한 내용은 hdrstop를 참조하세요.

다음으로 다이어그램 APPLIB.obj 에서 최종 애플리케이션에 사용되는 지원 코드를 나타냅니다. 매크로에 APPLIB.cpp나열된 UNSTABLEHDRS 파일 및 미리 컴파일된 헤더에서 미리 컴파일된 코드에서 만들어집니다.

MYAPP.obj 는 최종 애플리케이션을 나타냅니다. 매크로에 MYAPP.cpp나열된 UNSTABLEHDRS 파일 및 미리 컴파일된 헤더에서 미리 컴파일된 코드에서 만들어집니다.

마지막으로 매크로 및 )에 나열된 파일을 연결하여 실행 파일(MYAPP.EXEAPPLIB.objMYAPP.obj)을 OBJS 만듭니다.

PCH에 대한 샘플 메이크파일

다음 메이크파일은 매크로 및 !IF제어 !ELSE!ENDIF 흐름 명령 구조를 사용하여 프로젝트에 대한 적응을 간소화합니다.

# Makefile : Illustrates the effective use of precompiled
#            headers in a project
# Usage:     NMAKE option
# option:    DEBUG=[0|1]
#            (DEBUG not defined is equivalent to DEBUG=0)
#
OBJS = myapp.obj applib.obj
# List all stable header files in the STABLEHDRS macro.
STABLEHDRS = stable.h another.h
# List the final header file to be precompiled here:
BOUNDRY = stable.h
# List header files under development here:
UNSTABLEHDRS = unstable.h
# List all compiler options common to both debug and final
# versions of your code here:
CLFLAGS = /c /W3
# List all linker options common to both debug and final
# versions of your code here:
LINKFLAGS = /nologo
!IF "$(DEBUG)" == "1"
CLFLAGS   = /D_DEBUG $(CLFLAGS) /Od /Zi
LINKFLAGS = $(LINKFLAGS) /COD
LIBS      = slibce
!ELSE
CLFLAGS   = $(CLFLAGS) /Oselg /Gs
LINKFLAGS = $(LINKFLAGS)
LIBS      = slibce
!ENDIF
myapp.exe: $(OBJS)
    link $(LINKFLAGS) @<<
$(OBJS), myapp, NUL, $(LIBS), NUL;
<<
# Compile myapp
myapp.obj  : myapp.cpp $(UNSTABLEHDRS)  stable.pch
    $(CPP) $(CLFLAGS) /Yu$(BOUNDRY)    myapp.cpp
# Compile applib
applib.obj : applib.cpp $(UNSTABLEHDRS) stable.pch
    $(CPP) $(CLFLAGS) /Yu$(BOUNDRY)    applib.cpp
# Compile headers
stable.pch : $(STABLEHDRS)
    $(CPP) $(CLFLAGS) /Yc$(BOUNDRY)    applib.cpp myapp.cpp

빌드 프로세스의 STABLEHDRSBOUNDRYUNSTABLEHDRS PCH 파일에서 "미리 컴파일된 헤더 파일을 사용하는 메이크파일의 구조"에 표시된 매크로 외에도 이 메이크파일은 매크로와 매크로를 CLFLAGSLINKFLAGS 제공합니다. 이러한 매크로를 사용하여 애플리케이션 실행 파일의 디버그 또는 최종 버전을 빌드할지 여부에 적용되는 컴파일러 및 링커 옵션을 나열해야 합니다. 프로젝트에 필요한 라이브러리를 LIBS 나열하는 매크로도 있습니다.

메이크파일은 NMAKE 명령줄에서 기호를 정의하는지 여부를 감지하기 위해 < !ENDIF!ELSEa0DEBUG/>도 사용합니다!IF.

NMAKE DEBUG=[1|0]

이 기능을 사용하면 개발 중과 프로그램의 최종 버전에서 동일한 메이크파일을 사용할 수 있습니다. 최종 버전에 사용합니다 DEBUG=0 . 다음 명령줄은 서로 동일합니다.

NMAKE
NMAKE DEBUG=0

메이크파일에 대한 자세한 내용은 NMAKE 참조를 참조하세요. MSVC 컴파일러 옵션 및 MSVC 링커 옵션도 참조하세요.

PCH에 대한 예제 코드

다음 원본 파일은 빌드 프로세스의 PCH 파일에 설명된 메이크파일 및 PCH용 샘플 메이크파일에서 사용됩니다. 주석에는 중요한 정보가 포함됩니다.

원본 파일 ANOTHER.H:

// ANOTHER.H : Contains the interface to code that is not
//             likely to change.
//
#ifndef __ANOTHER_H
#define __ANOTHER_H
#include<iostream>
void savemoretime( void );
#endif // __ANOTHER_H

원본 파일 STABLE.H:

// STABLE.H : Contains the interface to code that is not likely
//            to change. List code that is likely to change
//            in the makefile's STABLEHDRS macro.
//
#ifndef __STABLE_H
#define __STABLE_H
#include<iostream>
void savetime( void );
#endif // __STABLE_H

원본 파일 UNSTABLE.H:

// UNSTABLE.H : Contains the interface to code that is
//              likely to change. As the code in a header
//              file becomes stable, remove the header file
//              from the makefile's UNSTABLEHDR macro and list
//              it in the STABLEHDRS macro.
//
#ifndef __UNSTABLE_H
#define __UNSTABLE_H
#include<iostream>
void notstable( void );
#endif // __UNSTABLE_H

원본 파일 APPLIB.CPP:

// APPLIB.CPP : This file contains the code that implements
//              the interface code declared in the header
//              files STABLE.H, ANOTHER.H, and UNSTABLE.H.
//
#include"another.h"
#include"stable.h"
#include"unstable.h"
using namespace std;
// The following code represents code that is deemed stable and
// not likely to change. The associated interface code is
// precompiled. In this example, the header files STABLE.H and
// ANOTHER.H are precompiled.
void savetime( void )
    { cout << "Why recompile stable code?\n"; }
void savemoretime( void )
    { cout << "Why, indeed?\n\n"; }
// The following code represents code that is still under
// development. The associated header file is not precompiled.
void notstable( void )
    { cout << "Unstable code requires"
            << " frequent recompilation.\n";
    }

원본 파일 MYAPP.CPP:

// MYAPP.CPP : Sample application
//             All precompiled code other than the file listed
//             in the makefile's BOUNDRY macro (stable.h in
//             this example) must be included before the file
//             listed in the BOUNDRY macro. Unstable code must
//             be included after the precompiled code.
//
#include"another.h"
#include"stable.h"
#include"unstable.h"
int main( void )
{
    savetime();
    savemoretime();
    notstable();
}

참고 항목

헤더 단위, 모듈 및 미리 컴파일된 헤더 비교
C/C++ 빌드 참조
MSVC 컴파일러 옵션 C++의 모듈 개요
자습서: 모듈을 사용하여 C++ 표준 라이브러리 가져오기
연습: Visual C++ 프로젝트에서 헤더 단위 빌드 및 가져오기
연습: STL 라이브러리를 헤더 단위로 가져오기

미리 컴파일된 헤더 파일

미리 컴파일된 사용자 지정 코드

소스 코드를 미리 컴파일해야 하는 경우

코드를 미리 컴파일하기 위한 두 가지 선택 사항

미리 컴파일된 헤더 일관성 규칙

미리 컴파일된 헤더의 파일별 사용에 대한 일관성 규칙

컴파일러 옵션 일관성

C 7.0 호환(`/Z7`)

경로 일관성 포함

원본 파일 일관성

Pragma 일관성

/Yc 및 /Yu에 대한 일관성 규칙

컴파일러 옵션 일관성

프로젝트에서 미리 컴파일된 헤더 사용

빌드 프로세스의 PCH 파일

PCH에 대한 샘플 메이크파일

PCH에 대한 예제 코드

참고 항목

피드백

피드백

추가 리소스

미리 컴파일된 헤더 파일

미리 컴파일된 사용자 지정 코드

소스 코드를 미리 컴파일해야 하는 경우

코드를 미리 컴파일하기 위한 두 가지 선택 사항

미리 컴파일된 헤더 일관성 규칙

미리 컴파일된 헤더의 파일별 사용에 대한 일관성 규칙

컴파일러 옵션 일관성

C 7.0 호환(/Z7)

경로 일관성 포함

원본 파일 일관성

Pragma 일관성

/Yc 및 /Yu에 대한 일관성 규칙

컴파일러 옵션 일관성

프로젝트에서 미리 컴파일된 헤더 사용

빌드 프로세스의 PCH 파일

PCH에 대한 샘플 메이크파일

PCH에 대한 예제 코드

참고 항목

피드백

피드백

추가 리소스

C 7.0 호환(`/Z7`)