使用Qt+CMake开发时，如何避免生成超大PDB/ILK文件且保留调试信息？

完全可以实现需求，核心思路是让MSVC链接器仅保留你的项目代码调试信息，不将Qt库的调试信息合并到主程序PDB中，调试时通过外部引用方式查找Qt的PDB（后续若需调试Qt内部，可手动指定路径）。

具体CMake配置步骤 #

1. 确保自身代码的调试信息生成 #

Debug模式下，MSVC默认通过/Zi生成完整调试信息，CMake的CMAKE_CXX_FLAGS_DEBUG已包含该参数，无需额外修改。若需更精简但仍保留自身代码调试能力的信息，可替换为轻量版/Z7，但/Zi的灵活性更强，一般推荐保留。

2. 配置链接器选项，排除Qt调试信息 #

在CMakeLists.txt中添加以下配置，针对MSVC编译器设置链接器参数：

if(MSVC AND CMAKE_BUILD_TYPE STREQUAL "Debug")
    # 优化链接，移除未引用代码并合并重复代码
    target_link_options(你的项目名称 PRIVATE
        /OPT:REF
        /OPT:ICF
        # 告知链接器Qt库调试信息在外部PDB，无需合并到主PDB
        /PDBALTPATH:Qt5*.pdb
        # 禁用增量链接，避免生成过大ILK文件
        /INCREMENTAL:NO
    )

    # 可选：自定义PDB名称与输出目录，避免和Qt的PDB混淆
    set_target_properties(你的项目名称 PROPERTIES
        PDB_NAME "${PROJECT_NAME}_debug"
        PDB_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/pdb"
    )
endif()

注意将你的项目名称替换为实际的CMake目标名称。

3. 额外优化：阻止Qt目标传递调试信息 #

若上述配置效果仍不理想，可通过修改Qt导入目标的属性，阻止其将调试信息传递到你的项目：

if(MSVC AND CMAKE_BUILD_TYPE STREQUAL "Debug")
    # 遍历所有Qt调试库，清理其传递的编译/链接选项
    file(GLOB Qt_DEBUG_LIBS "${CMAKE_PREFIX_PATH}/lib/Qt5*.lib")
    foreach(Qt_LIB IN LISTS Qt_DEBUG_LIBS)
        get_filename_component(Qt_LIB_NAME "${Qt_LIB}" NAME_WE)
        if(TARGET ${Qt_LIB_NAME})
            set_target_properties(${Qt_LIB_NAME} PROPERTIES
                INTERFACE_COMPILE_OPTIONS ""
                INTERFACE_LINK_OPTIONS ""
            )
        endif()
    endforeach()
endif()

原理说明 #

• /OPT:REF & /OPT:ICF：链接器自动移除未被引用的代码、数据，合并重复的函数与数据，大幅压缩PDB和ILK文件体积。
• /INCREMENTAL:NO：禁用增量链接，增量链接为加快后续构建会生成较大ILK文件，禁用后首次构建稍慢，但后续生成的文件体积会显著缩小。
• /PDBALTPATH:Qt5*.pdb：告诉链接器Qt的调试信息存储在外部的Qt5*.pdb文件中，无需将内容合并到主程序PDB，调试时会自动搜索这些外部PDB（前提是Qt的PDB路径在调试器搜索范围内）。

配置完成后，项目PDB仅包含自身代码的调试信息，体积会大幅降低，完全不影响调试自己的代码；若后续需要调试Qt内部，只需将Qt的PDB路径添加到Visual Studio的调试符号搜索路径即可。

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