手动声明Win32 API后MinGW链接器符号不匹配问题求解

你遇到的核心问题是C++名字修饰机制导致的符号不匹配：

• 用g++（C编译器）编译时，你手动声明的Sleep()会被C编译器加上专属的名字修饰，生成类似__imp___Z5Sleepm@4的符号；
• 但Cygwin的libkernel32.a里Win32 API的符号是C风格的（比如_imp__Sleep@4），两者格式不匹配，所以链接报错。

而<windows.h>头文件里的所有Win32 API声明，都被extern "C"块包裹了——这会告诉C编译器，用C语言的规则处理这些函数的符号，不会添加C风格的修饰，所以直接包含头文件时能正常链接。

修正后的代码 #

把你的手动声明放在extern "C"块里即可：

extern "C" {
#define DECLSPEC_IMPORT __declspec(dllimport)
#define WINAPI __stdcall
#define WINBASEAPI DECLSPEC_IMPORT
typedef unsigned long DWORD;
WINBASEAPI void WINAPI Sleep(DWORD);
}

int main() {
   Sleep(1);
   
   return 0;
}

验证说明 #

修改后重新编译，目标文件里的符号会变成C风格的__imp__Sleep@4，和libkernel32.a里的符号完全匹配，链接就能成功了。

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