VS环境下CMake install()为何在Debug构建时查找Release目录文件？

这个问题在使用Visual Studio这类多配置生成器时很常见，根源在于你自定义的install_package函数里，add_custom_command直接调用cmake -P cmake_install.cmake时，没有明确指定当前构建的配置。

在多配置环境下，cmake_install.cmake需要知道要处理哪个配置（Debug/Release），如果不传递这个参数，它会默认使用项目的"默认配置"（通常是Release），这就导致Debug构建时它依然去Release目录找库文件，自然会报错。另外你提到添加CONFIGURATIONS选项没效果，大概率是没有结合配置变量一起使用，下面是修正后的完整方案：

修正后的CMake代码 #

cmake_minimum_required(VERSION 2.8.4)
project(math)

add_library(math math.cpp)

function(install_package)
    # 明确指定install命令针对的配置，避免跨配置混淆
    install(TARGETS math 
            LIBRARY DESTINATION lib
            ARCHIVE DESTINATION lib
            CONFIGURATIONS Debug Release)
    
    # 在POST_BUILD命令中传递当前构建的配置给cmake_install.cmake
    add_custom_command(TARGET math POST_BUILD
        COMMAND ${CMAKE_COMMAND} -P cmake_install.cmake
        ARGS -DCMAKE_INSTALL_CONFIG_NAME=$<CONFIG>
        WORKING_DIRECTORY ${CMAKE_BINARY_DIR})
endfunction()

install_package()

关键修改点说明 #

• install命令添加CONFIGURATIONS：明确告诉CMake这个install规则只对Debug和Release配置生效，避免无关配置的干扰。
• 传递CMAKE_INSTALL_CONFIG_NAME参数：$<CONFIG>是CMake的生成器表达式，会自动替换为当前构建的配置（Debug/Release），让cmake_install.cmake精准定位到对应配置的库文件。
• 指定WORKING_DIRECTORY：确保命令在构建根目录执行，避免因路径上下文错误导致的文件查找问题。

这样修改后，Debug构建时会正确查找build/Debug/math.lib，Release构建也会保持正常工作。

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