如何用vcperf识别CMake+MSVC项目中低效的预编译头？

一、识别pch.h中低效头文件的核心策略 #

• 核对实际依赖：把pch.h里的每个头文件跟项目所有静态/动态目标的实际引用情况逐一比对，标记出仅被个别目标用到、甚至完全没被引用的头——这类头绝对没必要放进全局PCH。
• 拆分全局与局部PCH：如果不同目标的依赖差异大，别硬凑单个PCH。把STL基础头、项目公共宏这类全项目通用的内容放进全局PCH，特定目标的专属依赖单独做局部PCH，减少冗余预编译。
• 排查头文件膨胀：有些头会间接引入大量无关内容，比如某个业务头不小心包含了<windows.h>但只用到几个宏，直接换成<winbase.h>或者手动定义所需宏，避免把整个大库拖进PCH。
• 增量测试验证：每次从pch.h移除一个疑似低效的头，编译整个项目看是否报错，同时记录耗时变化。如果移除后编译正常且耗时下降，就确定这个头可以删掉。

二、用vcperf分析PCH低效头文件的具体方法 #

• 生成编译跟踪文件：先执行vcperf start -output:pch_analysis.etl启动跟踪，正常编译完项目后，再执行vcperf stop pch_analysis.etl生成trace文件。
• 获取头文件耗时统计：运行vcperf report pch_analysis.etl -summary:headers，报告会列出每个头文件的总编译时间、被引用次数、是否属于PCH。重点盯总耗时高但被引用次数极少的头，这类就是PCH里的低效项。
• 查看PCH预编译明细：用vcperf report pch_analysis.etl -summary:pch查看PCH预编译阶段的耗时占比，能清楚看到pch.h里每个头的耗时贡献。如果某个头占比很高但项目里很少用到，直接移出就行。
• 对比优化前后数据：移除疑似低效头后，重新生成trace并对比两次的报告，确认耗时下降且无编译错误，就能坐实优化效果。

三、额外注意事项 #

• 避免PCH滥用：频繁修改的头别放进PCH，不然每次改都要重新预编译，反而拖慢速度。
• CMake配置适配：确保CMake里正确设置PRECOMPILE_HEADERS和PRECOMPILE_HEADER_REUSE_FROM，让全局PCH能被多目标复用，同时支持局部PCH的单独配置。
• 配合MSVC编译选项：开启/MP多进程编译，能放大PCH的优化效果；同时注意/Yu和/Yc选项的正确配置，避免PCH生成或复用出错。

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