如何在CMake中插入PowerShell命令生成带时间戳的PDB文件

我基于ImGui API开发了绘图函数，编译为DLL实现运行时热重载。Release模式运行正常，但Debug模式下.pdb文件会被调试器锁定，导致重新编译时链接器无法覆盖旧PDB，最终生成库失败。

为解决这个问题，我计划每次编译生成带时间戳的新PDB文件，用PowerShell命令get-date -uformat %H%M%S生成时间戳，链接器通过/PDB:参数指定文件名。目标是让CMake给链接器添加选项/PDB:file_name_$(get-date -uformat %H%M%S).pdb，但CMake会解析$()，导致内部内容被替换为空。

我尝试过用变量单独存储$、(、)字符，message输出正常，但编译时$()内的内容仍会丢失。后续又试了[=[...]=]引用和Ninja生成器：

• 使用Visual Studio 17 2022生成器时，$()被CMD解析为空
• 使用Ninja生成器时，$被加倍，依旧无法正常执行PowerShell命令

现在需要让CMake输出原始的$()，确保PowerShell能正常解析执行时间戳命令。

针对Visual Studio生成器（默认CMD环境） #

VS生成器默认通过CMD执行构建命令，要让PowerShell解析$()，需要将整个链接逻辑包裹在PowerShell调用中，避免CMD提前解析$符号：

if(MSVC AND CMAKE_BUILD_TYPE STREQUAL "Debug")
    # 保存原始链接命令模板
    set(ORIGINAL_LINK_CMD "${CMAKE_CXX_LINK_EXECUTABLE}")
    # 替换/PDB参数为带PowerShell时间戳的动态文件名
    string(REPLACE "/PDB:<TARGET_PDB>" "/PDB:file_name_$(get-date -uformat %H%M%S).pdb" MODIFIED_LINK_CMD "${ORIGINAL_LINK_CMD}")
    # 用PowerShell执行修改后的链接命令
    set(CMAKE_CXX_LINK_EXECUTABLE "powershell -Command \"${MODIFIED_LINK_CMD}\"")
endif()

注意：如果链接命令中包含双引号，需要用反斜杠转义，确保PowerShell能正确解析整个命令串。

针对Ninja生成器 #

Ninja会自动将$转义为$$，因此要让最终传递给PowerShell的是$()，需要在CMake中写$$()：

if(CMAKE_GENERATOR STREQUAL "Ninja" AND CMAKE_BUILD_TYPE STREQUAL "Debug")
    set(CMAKE_SHARED_LINKER_FLAGS "${CMAKE_SHARED_LINKER_FLAGS} /PDB:file_name_$$(get-date -uformat %H%M%S).pdb")
endif()

Ninja构建时会把$$替换为单个$，最终链接器参数会变成/PDB:file_name_$(get-date -uformat %H%M%S).pdb，PowerShell就能正常执行时间戳命令。

通用兼容方案（所有生成器） #

如果需要跨生成器兼容，可以通过自定义PowerShell脚本生成时间戳，再让CMake读取结果作为PDB文件名：

1. 创建generate_pdb_name.ps1脚本：

$timestamp = get-date -uformat %H%M%S
Write-Output "file_name_$timestamp.pdb"

2. 在CMakeLists.txt中配置：

if(CMAKE_BUILD_TYPE STREQUAL "Debug")
    # 复制脚本到构建目录
    configure_file(generate_pdb_name.ps1 generate_pdb_name.ps1 COPYONLY)

    # 自定义命令：每次构建时生成新的PDB文件名并写入文本
    add_custom_command(
        OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/pdb_name.txt
        COMMAND powershell -ExecutionPolicy Bypass -File ${CMAKE_CURRENT_BINARY_DIR}/generate_pdb_name.ps1 > ${CMAKE_CURRENT_BINARY_DIR}/pdb_name.txt
        MAIN_DEPENDENCY generate_pdb_name.ps1
    )

    # 链接库目标
    add_library(MyImGuiDLL SHARED src/main.cpp)
    # 依赖PDB文件名生成命令，确保每次构建先更新文件名
    add_dependencies(MyImGuiDLL ${CMAKE_CURRENT_BINARY_DIR}/pdb_name.txt)

    # 读取生成的PDB文件名并设置给目标
    file(STRINGS ${CMAKE_CURRENT_BINARY_DIR}/pdb_name.txt PDB_NAME)
    set_target_properties(MyImGuiDLL PROPERTIES
        PDB_NAME ${PDB_NAME}
    )
endif()

这个方案会在每次构建前执行PowerShell脚本生成新的时间戳文件名，彻底避免旧PDB被锁定的问题，同时兼容所有生成器。

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