在Sublime Text中使用SDL时出现「未定义引用@WinMain16」错误如何修复

核心问题根源 #

undefined reference to @WinMain16是32位Windows平台MinGW编译SDL2的典型入口符号不匹配问题，报错里的@WinMain16是32位stdcall调用约定下，大写WinMain函数的修饰符号名（后缀16对应WinMain四个参数的总字节数，每个参数占4字节）。
你当前的代码和链接配置存在两个直接问题：

• 入口函数大小写不匹配：你写了全小写的winmain，生成的符号名是winmain@16，和SDL2main库内部要求跳转的大写WinMain@16不是同一个符号，自然无法找到对应实现。
• 库位数可能不匹配：你指定了-m32编译32位程序，如果C:/SDL2-w64/lib路径下存放的是64位SDL2main库，也会出现符号匹配失败的问题，结合当前报错特征，大小写问题是首要诱因。

可直接套用的修正方法 #

适配GUI程序的修正方案 #

如果你是按照教程做Windows GUI SDL2程序，直接修正入口函数的大小写和签名即可：

#include <SDL2/SDL.h>
#include <iostream>

// 注意大写开头的WinMain，签名匹配SDL2main的预期要求
int WinMain(int argc, char const *argv[]){
    std::cout << "Hello";
    return 0;
}

注：如果出现WinMain参数类型不匹配的报错，只要保证函数名是大写WinMain即可，SDL2main库会自动处理Windows专属的实例参数，不需要额外添加HINSTANCE等类型参数。

适配控制台调试的修正方案 #

如果你只是想跑简单测试程序，用控制台入口更方便，不需要走GUI入口：

1. 代码里把入口函数改成标准小写main：

   #include <SDL2/SDL.h>
   #include <iostream>
   
   int main(int argc, char const *argv[]){
       std::cout << "Hello";
       return 0;
   }
   

2. 调整链接命令，去掉强制要求GUI入口的两个依赖参数：
   修正后的编译命令：

   g++ -c src/*.cpp -std=c++14 -g -Wall -m32 -I C:/SDL2-w64/include && g++ *.o -o ./bin/debug/main -L C:/SDL2-w64/lib -lSDL2 && start ./bin/debug/main
   

额外排查项 #

如果改完上述内容仍报错，检查SDL2库的路径指向：SDL2-w64预编译包的lib目录一般会分x86（32位）和x64（64位）子文件夹，你加了-m32必须把-L指向32位库的存放路径，避免链接到64位库导致符号不兼容。

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