Windows下如何在CMake中正确链接已安装的mosquittopp库？

问题根源 #

从错误信息里的__imp__ZN6mosqpp8lib_initEv可以判断，你正在用MinGW编译器链接官方提供的mosquitto库，但官方Windows版本的mosquitto库是用MSVC编译的，两者的导入库格式不兼容：MinGW使用.a/.dll.a作为动态链接库的导入库，而MSVC使用.lib，直接跨环境链接会导致符号解析失败。

解决方案 #

方案1：使用MinGW编译的mosquitto库（推荐） #

官方未提供MinGW预编译库，需自行编译：

1. 下载mosquitto源码
2. 打开MinGW终端环境（如MSYS2的MinGW shell）
3. 编译时开启C++库支持：

   cmake -G "MinGW Makefiles" -DWITH_CPP=ON ..
   mingw32-make
   

4. 编译完成后，会得到libmosquittopp.dll.a（动态导入库）和libmosquittopp.a（静态库）
5. 修改CMakeLists.txt，链接编译好的MinGW版本库：

   cmake_minimum_required(VERSION 3.15) 
   project(sandbox LANGUAGES CXX)
   
   add_executable(MainFile main.cpp)
   
   # 替换为你编译得到的mosquitto头文件和库路径
   target_include_directories(MainFile PUBLIC "/path/to/mosquitto/src")
   target_link_libraries(MainFile "/path/to/mosquitto/build/lib/libmosquittopp.dll.a")
   # 必须同时链接mosquitto核心基础库
   target_link_libraries(MainFile "/path/to/mosquitto/build/lib/libmosquitto.dll.a")
   
   set_property(TARGET MainFile PROPERTY CXX_STANDARD 17)
   set_property(TARGET MainFile PROPERTY CXX_STANDARD_REQUIRED On)
   set_property(TARGET MainFile PROPERTY CXX_EXTENSIONS Off)
   

方案2：改用MSVC编译器 #

若不想自行编译库，可切换到MSVC编译器（如使用Visual Studio开发环境）：

1. 打开Visual Studio的Developer Command Prompt
2. 重新运行CMake，指定MSVC生成器：

   cmake -G "Visual Studio 17 2022" ..
   

3. 此时官方提供的mosquittopp.lib可正常链接，原CMakeLists.txt只需确保路径正确即可。

常见误区 #

• 直接将MSVC的.lib文件给MinGW链接：两者格式不兼容，必然触发符号未定义错误
• 遗漏链接mosquitto核心库：mosquittopp是基于mosquitto核心库的封装，必须同时链接核心库才能正常工作

内容的提问来源于stack exchange，提问作者Ravshan S.K.