在Linux下用MinGW-w64编译含Winsock2的Windows项目报错解决

核心问题分析 #

报错WSACleanup was not declared in this scope本质是Winsock相关函数的声明未被正确引入，主要由头文件保护宏误用、交叉编译环境下Windows宏未正确定义这两个原因导致。

解决方案1：移除头文件中的_WINSOCKAPI_定义 #

你在头文件开头定义的#define _WINSOCKAPI_是<winsock2.h>内部用于防止重复包含的保护宏。提前定义它会直接跳过整个<winsock2.h>的内容加载，导致所有Winsock函数的声明都缺失。

修改后的头文件代码：

#define WIN32_LEAN_AND_MEAN

#ifdef _WIN32
    #include <winsock2.h>
    #include <ws2tcpip.h>
#endif

#include "json.hpp"
#include "utils.h"
#include "ssh.h"

解决方案2：显式添加Windows编译宏 #

交叉编译场景下，MinGW-w64可能不会自动定义_WIN32宏，导致代码中#ifdef _WIN32分支不生效，Winsock头文件根本没被包含。在CMakeLists中添加编译定义强制开启Windows环境标识：

修改后的CMakeLists关键片段：

# 显式定义Windows平台宏，确保#ifdef _WIN32分支生效
add_compile_definitions(_WIN32 WIN32)

if (${CMAKE_SYSTEM_NAME} MATCHES "Windows")
    enable_language("RC")
    set (WIN32_RESOURCES ${CMAKE_CURRENT_SOURCE_DIR}/usbclient.rc)
endif()

解决方案3：调整头文件包含顺序 #

将Winsock头文件的包含块移到第三方头文件（如json.hpp）之前，避免第三方库意外引入旧的<winsock.h>，引发头文件版本冲突。这一步已在解决方案1的代码中完成。

额外注意事项 #

• 无需使用Windows Kits的ws2_32.lib：MinGW-w64工具链自带适配的Windows系统库，直接通过target_link_libraries链接WS2_32即可，外部引入的lib可能与MinGW的编译环境不兼容。
• 确认MinGW工具链完整性：确保安装的MinGW-w64包含完整的Windows API头文件和库，部分精简版可能缺失Winsock相关文件。

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