如何调试仅Release模式崩溃的CMake构建二进制并生成带PDB的Release版本

一、让Release模式生成与RelWithDebInfo完全一致的二进制 #

CMake针对MSVC的Release和RelWithDebInfo模式，默认编译选项的核心差异在于是否生成调试信息（/Zi开关），部分场景下可能还有链接选项的细微差别。要让两者生成完全相同的二进制，只需将Release模式的编译、链接选项对齐到RelWithDebInfo的配置：

在CMakeLists.txt中添加以下配置：

# 对齐Release模式的编译选项到RelWithDebInfo
set(CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELWITHDEBINFO}")
set(CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELWITHDEBINFO}")

# 对齐Release模式的链接选项到RelWithDebInfo
set(CMAKE_EXE_LINKER_FLAGS_RELEASE "${CMAKE_EXE_LINKER_FLAGS_RELWITHDEBINFO}")
set(CMAKE_SHARED_LINKER_FLAGS_RELEASE "${CMAKE_SHARED_LINKER_FLAGS_RELWITHDEBINFO}")
set(CMAKE_MODULE_LINKER_FLAGS_RELEASE "${CMAKE_MODULE_LINKER_FLAGS_RELWITHDEBINFO}")

设置完成后，CMAKE_BUILD_TYPE=Release会使用和RelWithDebInfo完全相同的编译、链接参数，生成的二进制也会一致，你可以直接用该模式编译出的程序结合pdb文件调试特定宿主中的崩溃问题。

二、为“标准Release模式”生成PDB文件 #

如果你需要保留Release模式的默认优化级别，同时生成调试信息（PDB文件），无需对齐到RelWithDebInfo，只需单独为Release模式添加调试信息生成开关即可：

在CMakeLists.txt中添加：

# 为Release模式添加PDB生成开关
set(CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /Zi")
set(CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE} /Zi")

# 确保链接器生成PDB，且不影响优化
set(CMAKE_SHARED_LINKER_FLAGS_RELEASE "${CMAKE_SHARED_LINKER_FLAGS_RELEASE} /DEBUG /OPT:REF /OPT:ICF")
set(CMAKE_EXE_LINKER_FLAGS_RELEASE "${CMAKE_EXE_LINKER_FLAGS_RELEASE} /DEBUG /OPT:REF /OPT:ICF")

• /Zi：生成程序数据库（PDB），包含完整的调试信息
• /DEBUG：告诉链接器将调试信息写入PDB文件
• /OPT:REF 和 /OPT:ICF：保留Release模式的链接优化（移除未引用函数、合并重复代码），不会因生成PDB降低优化程度

配置后，标准Release模式会生成带PDB的优化二进制，既保留了Release的性能，又能用于调试崩溃问题。

注意事项 #

• 调整选项后，需清理原有构建目录，重新运行CMake生成新工程文件，避免旧配置残留
• 部分宿主程序可能对带调试信息的插件存在兼容性问题，测试时需确认插件能正常加载
• 如果崩溃由优化触发（比如未定义行为被优化放大），即使有PDB，调试时可能仍需结合反汇编代码分析

内容的提问来源于stack exchange，提问作者Sjoerd van Kreel