如何对比vcpkg启用/禁用状态下项目构建差异，排查WinAPI调用故障

1. 头文件引用差异核查 #

• 项目属性→C/C++→预处理器→生成预处理文件，选择带行号(/P)，分别在启用/禁用vcpkg的配置下生成.i预处理文件
• 用文本对比工具对比两个.i文件的头部引用路径部分，重点检查是否有头文件路径指向vcpkg安装目录下的include文件夹，尤其是Windows API相关的头是否被vcpkg的替代头覆盖
• 额外核查#define宏定义差异：重点看WINVER、_WIN32_WINNT、UNICODE这类和WinAPI绑定的宏是否被vcpkg的全局配置修改，宏定义差异是最容易导致WinAPI调用签名不匹配、调用失败的原因

2. 链接库依赖差异核查 #

• 项目属性→链接器→常规→显示进度，选择显示所有进度(/VERBOSE)，重新生成两次构建，把构建输出日志分别保存为log_enable_vcpkg.txt和log_disable_vcpkg.txt
• 搜索日志中的Searching和Adding关键字，提取所有被搜索的库路径、被链接的.lib文件清单，对比是否有启用vcpkg后额外链接的vcpkg提供的库，比如vcpkg自动注入的静态运行时补丁、适配库等
• 执行dumpbin /dependents 你的.dll分别导出两个版本DLL的依赖项，核对是否有额外的系统库或第三方库依赖

3. 符号与二进制差异核查 #

• 用dumpbin /symbols 你的.dll分别导出两个版本的完整符号表，对比是否有启用vcpkg后新增的非项目代码符号，以及WinAPI相关的导入符号名称、序号是否一致，检查是否存在符号名前缀/后缀差异，比如宽字符/多字节不匹配导致的导入错误
• 用dumpbin /exports 你的.dll对比导出表是否有差异，确保项目的导出接口没有被vcpkg的编译选项修改
• 用dumpbin /headers 你的.dll对比PE头信息，重点看节表的大小、数量差异，定位新增的40KB体积来自哪个节：如果是.text段变大说明有额外代码被链接，如果是.data段变大说明有额外全局数据被注入
• 对体积差异部分，用二进制对比工具拆分定位新增内容的来源，结合符号表对应到具体的链接库

额外排查点 #

• 检查vcpkg的全局triplet配置是否和项目配置匹配：项目用的是static/MD，确认vcpkg的triplet是x64-windows-static-md，如果triplet不匹配，vcpkg会强制注入运行时编译选项，导致和项目配置冲突
• 检查项目的VcpkgConfiguration属性是否自动添加了额外的编译/链接选项：vcpkg启用时会自动给项目追加/I、/link等参数，可在项目属性→C/C++→命令行、链接器→命令行中，对比两次配置下的最终命令行参数差异
• 调试时直接对比WinAPI调用的栈帧：启用vcpkg时在失败的WinAPI调用处下断点，查看传入参数、函数实际跳转地址是否和禁用vcpkg时一致，判断是否存在函数跳转被hook、参数被篡改的情况

内容的提问来源于stack exchange，提问作者Mr. Boy