CMake项目用相对路径设置IMPORTED属性触发LNK1104错误

问题重现 #

用户CMake配置代码：

cmake_minimum_required(VERSION 3.25)

project(GarbageCollector C)

set(CMAKE_C_STANDARD 23)

set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/bin)

add_library(collections SHARED IMPORTED)

set_target_properties(collections PROPERTIES
        IMPORTED_IMPLIB "lib/Release/Collections.lib"
        IMPORTED_LOCATION "bin/Debug/Collections.dll")
add_executable(gc ./main.c)

target_link_libraries(gc collections)

执行cmake --build build时触发LNK1104错误，提示无法打开Collections.lib。

核心原因及解决步骤 #

1. 修正路径基准问题 #

CMake默认以构建目录（即你执行cmake时指定的build文件夹）为基准查找文件，而非项目根目录。当前配置中的相对路径容易出现查找偏差，改用绝对路径修复：

set_target_properties(collections PROPERTIES
        IMPORTED_IMPLIB "${CMAKE_CURRENT_SOURCE_DIR}/lib/Release/Collections.lib"
        IMPORTED_LOCATION "${CMAKE_CURRENT_SOURCE_DIR}/bin/Debug/Collections.dll")

2. 匹配Debug/Release配置 #

当前配置混用了Release版.lib和Debug版.dll，构建时如果切换配置（比如默认是Debug），链接器会找不到对应配置的.lib。为不同配置分别设置属性：

set_target_properties(collections PROPERTIES
        # Release配置
        IMPORTED_IMPLIB_RELEASE "${CMAKE_CURRENT_SOURCE_DIR}/lib/Release/Collections.lib"
        IMPORTED_LOCATION_RELEASE "${CMAKE_CURRENT_SOURCE_DIR}/bin/Release/Collections.dll"
        # Debug配置
        IMPORTED_IMPLIB_DEBUG "${CMAKE_CURRENT_SOURCE_DIR}/lib/Debug/Collections.lib"
        IMPORTED_LOCATION_DEBUG "${CMAKE_CURRENT_SOURCE_DIR}/bin/Debug/Collections.dll")

3. 确认库文件实际存在 #

• 手动检查指定路径下是否真的有Collections.lib文件；
• 如果是自行编译的collections库，确认编译时生成了对应的导入库（Windows下共享库编译会同时产出.lib和.dll）；
• 如果是第三方库，确保下载的包包含对应架构（x86/x64）和配置的.lib文件。

4. 统一构建架构 #

确保CMake生成的项目架构与Collections.lib的架构一致（x86/x64不匹配会触发链接错误）。执行CMake时指定架构：

cmake -S . -B build -A x64

再执行cmake --build build完成构建。

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