如何让MSVC生成带调试符号的可复现构建产物？

你遇到的问题是：使用/Brepro配合/Zi编译时，多次构建的EXE哈希值不一致，示例如下：

> echo int main() { return 0; } > temp.cpp

> cl /nologo /Brepro /Zi temp.cpp && certutil -hashfile temp.exe MD5 > NUL
MD5 hash of temp.exe:
d7fc95fa40dd28f458f059172ebe9451
CertUtil: -hashfile command completed successfully.

> cl /nologo /Brepro /Zi temp.cpp && certutil -hashfile temp.exe MD5 > NUL
MD5 hash of temp.exe:
56b71b75d746449eac6be9cb085edbd8
CertUtil: -hashfile command completed successfully.

解决这个问题可以从以下几个方面入手：

• 添加/FS编译器选项：默认情况下MSVC的PDB写入机制会引入非确定性，/FS强制使用共享PDB写入模式，确保每次构建时PDB的生成内容一致，进而让依赖它的EXE哈希稳定。
• 改用/Z7替代/Zi：/Z7会将调试符号直接嵌入到目标文件（EXE/DLL）中，不生成单独的PDB文件，从根源上避免PDB带来的不确定性，但会增大产物体积。
• 禁用增量链接：添加链接器选项/INCREMENTAL:NO，增量链接默认开启时会在输出文件中写入可变的增量信息，导致哈希不一致。
• 确保构建环境完全一致：固定MSVC工具链版本、Windows SDK版本，每次构建前清理所有中间文件（OBJ、PDB、旧EXE等），避免残留文件干扰。

修改后的编译命令示例：

cl /nologo /Brepro /Zi /FS /link /INCREMENTAL:NO temp.cpp

或者使用/Z7的版本：

cl /nologo /Brepro /Z7 /link /INCREMENTAL:NO temp.cpp

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