MinGW编译SDL2项目出现undefined reference to WinMain错误如何解决

报错原因 #

undefined reference to 'WinMain'是MinGW环境编译SDL2项目的典型错误，触发原因如下：

1. 编译命令参数错误
   你当前命令中-LSDL2main为错误写法：-L是用来指定库文件搜索路径的参数，链接指定名称的库需使用-l前缀，参数写错导致SDL2main库未被正确链接。
2. 头文件引入缺失
   SDL2通过头文件宏定义将代码中编写的main函数替换为SDL_main，由SDL2main库内置的WinMain入口调用该函数。如果代码未引入SDL2头文件，宏替换不会生效，也会触发入口找不到的报错。

解决方案 #

• 修正编译命令，将-LSDL2main替换为-lSDL2main，修正后完整命令：
  g++ -Isrc/include -Lsrc/lib -o main main.cpp -lmingw32 -lSDL2main -lSDL2
• 确认main.cpp顶部已正确引入SDL2头文件：

#include <SDL2/SDL.h>
// 若头文件搜索路径已直接指向SDL2内部目录，可简化为#include <SDL.h>

• 如无需SDL接管入口逻辑，可在编译参数中添加-DSDL_MAIN_HANDLED，即可保留原生main函数作为入口，不需要依赖SDL2main的包装逻辑。

内容的提问来源于stack exchange，提问作者Ân Trần