CMake导入目标配置正常但多配置环境下始终使用Debug版本

问题背景 #

作为CMake新手，我有一个名为Container的CMake包，已经为其导入目标定义了Debug和Release配置。但使用Visual Studio 2019（多配置生成器）以Release模式构建时，CMake配置阶段查询LOCATION属性始终返回Debug版本的路径。

环境 #

• CMake版本：3.24+
• 生成器：Visual Studio 16 2019（多配置）
• 平台：Windows 10
• 构建命令：cmake -DCMAKE_BUILD_TYPE=Release -B build .

当前现象 #

配置项目时，调试输出显示LOCATION属性始终返回带'd'后缀的Debug版本Containerd.dll路径，尽管已正确定义两种配置且设置了CMAKE_BUILD_TYPE=Release，且MAP_IMPORTED_CONFIG_*属性显示为NOTFOUND。

相关代码 #

已提供ContainerConfig.cmake.in及测试用例代码，其中针对多配置生成器未设置IMPORTED_LOCATION，仅为单配置生成器设置了对应属性。

疑问解答 #

1. 为何设置CMAKE_BUILD_TYPE=Release后，配置阶段LOCATION属性仍返回Debug版本？ #

CMAKE_BUILD_TYPE仅对单配置生成器（如Makefile、Ninja）生效，多配置生成器（如Visual Studio、Xcode）在配置阶段并不依赖这个变量。这类生成器支持同时生成所有配置的构建文件，CMake在配置阶段无法预知你最终会用哪个配置构建。此时查询LOCATION属性，CMake会返回导入目标中第一个定义的配置路径（这里刚好是Debug），或者默认的配置路径，和CMAKE_BUILD_TYPE无关。

2. 这是Visual Studio等多配置生成器的预期行为吗？如何确定将使用的配置？ #

这完全是预期行为。多配置生成器的核心特性就是一次配置、多版本构建，配置阶段不需要指定最终构建的配置。

要确定实际使用的配置，看两个地方：

• 命令行构建时，cmake --build build --config <CONFIG>中的--config参数就是最终使用的配置；
• 在Visual Studio IDE中，通过顶部工具栏的"解决方案配置"下拉菜单选择的活动配置，就是当前构建用的配置。

3. 实际构建是否会使用正确配置？如何验证？ #

只要你正确为导入目标设置了IMPORTED_LOCATION_DEBUG和IMPORTED_LOCATION_RELEASE这类分配置的属性，实际构建时指定对应--config参数，就会使用正确的配置版本。

验证方法：

• 查看构建日志：打开构建输出日志，搜索链接命令，检查其中引用的库路径是否是对应配置的版本（比如Release模式下是否是Container.dll而非Containerd.dll）；
• 检查二进制依赖：用Windows自带的dumpbin /dependents <生成的exe路径>命令，查看生成的可执行文件依赖的DLL名称；
• CMake生成器表达式输出：在CMakeLists.txt中添加一行调试输出：

  message(STATUS "实际构建时将使用的库路径: $<TARGET_FILE:Container>")
  

  执行构建命令时，这个表达式会根据--config参数展开为对应配置的实际文件路径，直接在控制台输出验证。

4. MAP_IMPORTED_CONFIG_*属性是否未正确设置？ #

如果你的导入目标使用的是CMake标准配置名称（Debug、Release、RelWithDebInfo、MinSizeRel），完全不需要设置MAP_IMPORTED_CONFIG_*属性，CMake会自动完成配置映射。这类属性仅用于导入目标的配置名称和CMake标准配置不匹配的场景（比如第三方库用"Debug"和"Opt"作为配置名）。

你看到MAP_IMPORTED_CONFIG_*显示为NOTFOUND是正常的，因为没有必要设置它们，CMake不会自动生成这些属性。

关键配置示例 #

确保你的ContainerConfig.cmake.in中，针对多配置生成器正确设置了分配置的导入属性，示例如下：

# 针对多配置生成器，分别设置各配置的路径
set_target_properties(Container PROPERTIES
  IMPORTED_LOCATION_DEBUG "${CONTAINER_DEBUG_DLL_PATH}"
  IMPORTED_LOCATION_RELEASE "${CONTAINER_RELEASE_DLL_PATH}"
  # 其他配置如RelWithDebInfo可按需添加
)

# 针对单配置生成器，根据CMAKE_BUILD_TYPE设置对应路径
if(CMAKE_BUILD_TYPE STREQUAL "Debug")
  set_target_properties(Container PROPERTIES
    IMPORTED_LOCATION "${CONTAINER_DEBUG_DLL_PATH}"
  )
else()
  set_target_properties(Container PROPERTIES
    IMPORTED_LOCATION "${CONTAINER_RELEASE_DLL_PATH}"
  )
endif()

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