如何在MSVC的cl.exe命令行中使用预编译头(PCH)

步骤1：准备文件 #

• headers.h（预编译头入口，包含不变的公共头）：

#pragma once
#include <windows.h>
#include <iostream>
// 其他你想预编译的头文件

• pch.cpp（仅用于生成PCH的空源文件）：

#include "headers.h"
// 无需编写业务代码，仅作为编译PCH的载体

• main.cpp（业务代码）：

#include "headers.h"

int main() {
    std::cout << "Hello with PCH!" << std::endl;
    MessageBox(nullptr, L"PCH Works!", L"Info", MB_OK);
    return 0;
}

步骤2：生成预编译头 #

打开MSVC命令行环境（如x64 Native Tools Command Prompt for VS 2022），进入文件目录执行：

cl /c /Ycheaders.h pch.cpp

• /c：仅编译，不执行链接
• /Ycheaders.h：指定以headers.h为入口创建预编译头，会生成headers.pch和pch.obj两个文件

步骤3：使用预编译头编译业务代码 #

执行命令：

cl /Yuheaders.h main.cpp pch.obj

• /Yuheaders.h：指定使用已生成的headers.pch预编译头
• 必须带上pch.obj：预编译头中依赖的全局初始化代码（如C++标准库静态对象）被编译到该目标文件中，缺失会导致链接错误

常见问题解释 #

1. 错误C1854：你之前用main.cpp生成PCH，之后再用/Yu编译同一个文件时，main.obj已包含预编译头创建时的信息，重复处理导致冲突。解决方式是必须用单独的源文件（如pch.cpp）生成PCH，业务代码文件仅负责使用PCH。

2. 未解析外部符号链接错误：生成PCH时会把预编译头相关的全局代码打包到pch.obj中，链接业务代码时必须传入该文件，否则编译器找不到初始化符号。

3. 编译参数一致性：生成PCH和使用PCH时的编译选项（如/MD//MT、/O2/Od等）必须完全一致，否则会出现预编译头版本不匹配错误。如需自定义PCH输出路径，可使用/Fp参数：

# 生成时指定路径
cl /c /Ycheaders.h /Fp"./build/my_pch.pch" pch.cpp
# 使用时对应指定
cl /Yuheaders.h /Fp"./build/my_pch.pch" main.cpp pch.obj

内容的提问来源于stack exchange，提问作者Serilena