VS_USE_DEBUG_LIBRARIES

在 3.30 版本中新增。

指示 Visual Studio 產生器 哪些組態被視為除錯組態。這會控制 .vcxproj 檔案中每個組態的 UseDebugLibraries 設定。

Visual Studio 專案中的「使用除錯函式庫」設定，儘管其名稱聽起來很具體，但它是一個通用的指標，指示哪些組態被視為除錯組態。在獨立專案中，這可能會影響 MSBuild 對 MSVC 執行時期函式庫、最佳化旗標、執行時期檢查和類似設定的預設選擇。在 CMake 專案中，這些設定通常會根據專案的規範明確產生，例如，MSVC 執行時期函式庫由 MSVC_RUNTIME_LIBRARY 控制。但是，UseDebugLibraries 指標對於人類和工具的參考都很有用，也可能會影響特定平台的 SDK 行為。

將 VS_USE_DEBUG_LIBRARIES 設定為 true 或 false 值，以指示每個組態是否被視為除錯組態。該值也可以是空字串 ("")，在這種情況下，CMake 不會明確添加 UseDebugLibraries，而 MSBuild 將使用其預設值 false。

使用 產生器運算式 進行每個組態的規範。例如，以下程式碼

add_executable(foo foo.c)
set_property(TARGET foo PROPERTY
  VS_USE_DEBUG_LIBRARIES "$<CONFIG:Debug,Custom>")

指示目標 foo 認為其「Debug」和「Custom」組態是除錯組態，而其他組態是非除錯組態。

此屬性從 CMAKE_VS_USE_DEBUG_LIBRARIES 變數的值初始化（如果已設定）。如果未設定此屬性，則 CMake 會使用啟發法來判斷哪些組態是除錯組態，並產生 UseDebugLibraries。請參閱政策 CMP0162。