CMAKE_MSVC_DEBUG_INFORMATION_FORMAT

在 3.25 版本中新增。

选择针对 MSVC ABI 的 MSVC 调试信息格式。此变量用于初始化创建的所有目标的 MSVC_DEBUG_INFORMATION_FORMAT 属性。它还会通过 try_compile() 命令传播到测试项目中。

允许的值为

Embedded

使用 -Z7 或等效标志编译,以生成具有完整符号调试信息的对象文件。

ProgramDatabase

使用 -Zi 或等效标志编译,以生成包含所有符号调试信息的用户数据库。

EditAndContinue

使用 -ZI 或等效标志编译,以生成支持“编辑并继续”功能的用户数据库。

对于不以 MSVC ABI 为目标编译器的编译器,此值将被忽略,但当使用以 MSVC ABI 为目标编译器的编译器时,不受支持的值将被视为错误。

该值也可以是空字符串(""),在这种情况下,CMake 不会显式添加任何调试信息格式标志。

使用 生成器表达式 来支持按配置进行指定。例如,以下代码

set(CMAKE_MSVC_DEBUG_INFORMATION_FORMAT "$<$<CONFIG:Debug,RelWithDebInfo>:ProgramDatabase>")

为所有后续目标选择 DebugRelWithDebInfo 配置的用户数据库调试信息格式。

如果未设置此变量,则 MSVC_DEBUG_INFORMATION_FORMAT 目标属性不会自动设置。如果未设置该属性,CMake 会使用默认值 $<$<CONFIG:Debug,RelWithDebInfo>:ProgramDatabase>(如果编译器支持)来选择调试信息格式,否则使用 $<$<CONFIG:Debug,RelWithDebInfo>:Embedded>

注意

此变量仅在策略 CMP0141 在启用使用针对 MSVC ABI 的编译器的语言的第一个 project()enable_language() 命令之前设置为 NEW 时才生效。