g++编译SDL2程序报Undefined reference to SDL_Init错误

使用g编译基于SDL2开发的C程序时，持续出现Undefined reference to SDL_Init报错，当前使用的Makefile编译配置如下：

all:
    g++ -I SDL2/include  -L SDL2/lib/x64  -o main main.cpp -lmingw32 -lSDL2 -lSDL2main

项目目录结构如下：

• 链接顺序错误：MinGW环境对SDL2的库链接顺序有强制要求，当前配置把-lSDL2main放在-lSDL2之后，会导致链接器无法正确解析SDL封装的入口函数，连带出现SDL_Init符号找不到的问题。
• 架构不匹配：若当前使用的g是32位版本，指向x64库路径会因为二进制架构不兼容无法解析符号；64位g链接32位SDL2库也会出现同类错误。
• 库文件缺失/不匹配：若指定的lib路径下缺少SDL2对应的导入库文件、头文件与库文件版本不对应、动态链接时未放置对应DLL，都会触发未定义引用错误。
• 静态链接缺少依赖：如果使用SDL2静态库但未追加SDL2依赖的Windows系统库，也会出现符号解析失败。

1. 优先修正链接顺序，这是该场景下最高发的问题，调整后的基础动态链接编译配置如下：

all:
    g++ -I SDL2/include -L SDL2/lib/x64 -o main main.cpp -lmingw32 -lSDL2main -lSDL2

2. 校验编译器与库的架构匹配性：终端执行g++ -v，查看输出中Target字段：
   • 若Target为i686-w64-mingw32（32位编译器），将链接路径SDL2/lib/x64改为SDL2/lib/x86
   • 若Target为x86_64-w64-mingw32（64位编译器），保留现有x64路径即可
3. 校验库文件完整性：确认SDL2/lib/x64（或x86）路径下存在libSDL2.dll.a、libSDL2main.a两个文件，动态链接编译时将对应路径下的SDL2.dll复制到最终生成的main.exe同目录。如果文件缺失，重新下载对应架构的SDL2 MinGW开发包替换现有SDL2目录下的文件即可。
4. 若需要静态编译SDL2，使用如下完整链接配置，补全所有SDL2依赖的系统库：

all:
    g++ -I SDL2/include -L SDL2/lib/x64 -o main main.cpp -lmingw32 -lSDL2main -lSDL2 -mwindows -lws2_32 -ldinput8 -ldxguid -ldxerr8 -luser32 -lgdi32 -lwinmm -limm32 -lole32 -loleaut32 -lshell32 -lversion -luuid -static

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