微软Win32教程代码构建失败提示WinMain@16错误如何解决

这个undefined reference to WinMain@16是MinGW GCC编译Win32 GUI程序的典型链接错误，由链接器找不到程序入口函数导致，按以下步骤排查修复即可：

1. 检查入口函数签名 #

确认代码中WinMain的定义完全符合标准格式，不能写错调用约定、参数类型和顺序：

#include <windows.h>

int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow)
{
    // 你的程序逻辑
    return 0;
}

其中WINAPI宏对应__stdcall调用约定，漏写或者写错都会触发链接错误。

2. 修改CMake配置（CLion默认使用CMake构建） #

打开项目根目录的CMakeLists.txt文件，做两处修改：

1. 在add_executable配置项中添加WIN32标记，示例：

add_executable(你的项目名称 WIN32 main.cpp)

2. 追加GUI程序专用的链接参数：

set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -mwindows")
# 32位MinGW可额外加下面这行，64位环境不需要
# set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -Wl,--enable-stdcall-fixup")

修改完成后点击CLion右上角的「Reload CMake Project」重新加载配置，再重新构建即可。

3. 其他排查项 #

• 确认CLion中配置的MinGW工具链位数（32位/64位）和你安装的版本一致，不要交叉混用
• 项目中不要同时定义main和WinMain两个入口函数，也不要添加-mconsole编译参数，该参数会强制要求入口为控制台程序的main函数
• 如果直接用g++命令行测试编译，直接在编译命令末尾加上-mwindows参数即可：

  g++ main.cpp -o test.exe -std=c++20 -mwindows
  

内容的提问来源于stack exchange，提问作者Sam-zhuang