Windows+MinGW环境下CMake导入fmt动态库失败问题排查

环境与项目信息 #

• 系统：Windows 10 + MinGW
• 项目路径：D:/CodeDraft/helloworld

项目结构 #

D:.
│  CMakeLists.txt
│  main.cpp
│  run_cmake.ps1
│
├─3rdparty
│  └─fmt_x64-mingw-dynamic
│      │  BUILD_INFO
│      │  CONTROL
│      │
│      ├─bin
│      │      libfmt.dll
│      │
│      ├─debug
│      │  ├─bin
│      │  │      libfmtd.dll
│      │  │
│      │  └─lib
│      │      │  libfmtd.dll.a
│      │      │
│      │      └─pkgconfig
│      │              fmt.pc
│      │
│      ├─include
│      │  └─fmt  

main.cpp代码 #

#include <fmt/core.h>
int main()
{
    fmt::print("Hello World!\n");
    return 0;
}

问题现象 #

通过vcpkg下载fmt库后，未使用vcpkg集成功能，参考CMake官方指南编写配置文件，CMake配置阶段成功，但执行make时出现：

• IMPORTED_IMPLIB not set警告
• fmt-NOTFOUND链接错误

补充测试：相同CMake写法在Ubuntu环境下可正常运行；直接使用g++原生命令或另一种CMake写法也能成功编译。

原因分析 #

1. MinGW与Linux动态库链接逻辑差异 #

Linux下动态库以.so为载体，CMake可自动识别处理；但MinGW下动态库需要依赖对应的.dll.a导入库完成链接。从项目结构看，fmt的Release版本仅提供libfmt.dll，缺失对应的libfmt.dll.a导入库，导致CMake无法找到链接所需文件。

2. CMake导入目标配置遗漏 #

若使用find_package(fmt REQUIRED)，CMake在MinGW环境下会优先查找pkgconfig配置或导入库。但当前Release目录缺少导入库，且Debug目录的pkgconfig配置未适配MinGW路径，导致CMake无法生成有效导入目标，触发IMPORTED_IMPLIB not set警告。

3. 官方指南的环境适配问题 #

参考的CMake官方指南多针对Linux或MSVC环境编写，未明确说明MinGW下需显式指定导入库路径的要求，导致配置不适配当前环境。

解决办法 #

方法1：补全fmt库的Release导入库 #

重新通过vcpkg安装fmt时，确保使用x64-mingw-dynamic triplet，并检查fmt_x64-mingw-dynamic/lib目录是否存在libfmt.dll.a文件。

方法2：手动配置CMake导入目标 #

在CMakeLists.txt中显式为Debug和Release版本指定动态库与导入库路径：

# 定义fmt导入目标
add_library(fmt SHARED IMPORTED)
# 设置头文件路径
set_target_properties(fmt PROPERTIES
    INTERFACE_INCLUDE_DIRECTORIES "${CMAKE_CURRENT_SOURCE_DIR}/3rdparty/fmt_x64-mingw-dynamic/include"
)

# 配置Debug模式
set_target_properties(fmt PROPERTIES
    IMPORTED_LOCATION_DEBUG "${CMAKE_CURRENT_SOURCE_DIR}/3rdparty/fmt_x64-mingw-dynamic/debug/bin/libfmtd.dll"
    IMPORTED_IMPLIB_DEBUG "${CMAKE_CURRENT_SOURCE_DIR}/3rdparty/fmt_x64-mingw-dynamic/debug/lib/libfmtd.dll.a"
)

# 配置Release模式（需确保libfmt.dll.a存在）
if(EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/3rdparty/fmt_x64-mingw-dynamic/lib/libfmt.dll.a")
    set_target_properties(fmt PROPERTIES
        IMPORTED_LOCATION_RELEASE "${CMAKE_CURRENT_SOURCE_DIR}/3rdparty/fmt_x64-mingw-dynamic/bin/libfmt.dll"
        IMPORTED_IMPLIB_RELEASE "${CMAKE_CURRENT_SOURCE_DIR}/3rdparty/fmt_x64-mingw-dynamic/lib/libfmt.dll.a"
    )
endif()

# 链接目标
target_link_libraries(helloworld PRIVATE fmt)

方法3：直接指定库路径与链接库 #

若不想使用导入目标，可直接设置头文件、库路径并链接：

include_directories("${CMAKE_CURRENT_SOURCE_DIR}/3rdparty/fmt_x64-mingw-dynamic/include")
link_directories(
    "${CMAKE_CURRENT_SOURCE_DIR}/3rdparty/fmt_x64-mingw-dynamic/debug/lib"
    "${CMAKE_CURRENT_SOURCE_DIR}/3rdparty/fmt_x64-mingw-dynamic/lib"
)

# 根据编译模式链接对应库
target_link_libraries(helloworld PRIVATE
    $<$<CONFIG:Debug>:fmtd>
    $<$<CONFIG:Release>:fmt>
)

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