Arquivo PCH

Um arquivo .pch é um cabeçalho pré-compilado - um cache binário do compilador gerado automaticamente durante o processo de build. Em vez de analisar novamente arquivos de cabeçalho grandes, como o Windows SDK ou stdafx.h, em cada unidade de compilação, o compilador serializa seu estado interno - tabelas de símbolos, nós AST, definições de macro, sinalizadores de include-guard - em um instantâneo .pch. As unidades de compilação subsequentes carregam esse instantâneo diretamente, reduzindo drasticamente os tempos de build para grandes projetos C e C++.

O MSVC produz arquivos .pch por meio da flag de compilador /Yc, normalmente a partir de um arquivo de origem stub dedicado chamado pch.cpp ou stdafx.cpp. O Clang armazena seus cabeçalhos pré-compilados como um bitstream LLVM compactado incorporado dentro de um arquivo de objeto nativo em uma seção chamada __clangast. O equivalente do GCC usa a extensão .gch em vez de .pch.

O formato é inteiramente interno do compilador - proprietário, binário e não transferível entre máquinas. Um arquivo .pch é invalidado sempre que a versão do compilador, as flags do compilador ou qualquer cabeçalho incluído mudam; o sistema de build o regenera automaticamente. Os tamanhos típicos variam de 10 MB a mais de 200 MB quando os cabeçalhos do Windows SDK estão incluídos.

Os usuários nunca criam ou abrem arquivos .pch manualmente. Excluir um é seguro - o próximo build o recria, e um clean rebuild é o remédio padrão para erros persistentes relacionados ao PCH. Os Módulos C++20 reduzem parcialmente a dependência de cabeçalhos pré-compilados em novas bases de código, mas o .pch continua sendo o mecanismo dominante de velocidade de compilação em projetos C e C++ existentes.