使用CMake FetchContent+MinGW构建SDL2 C++项目遇SDL_main未定义错误

问题根源 #

在MinGW环境下用CMake FetchContent构建SDL2项目时，出现undefined reference to SDL_main链接错误，是因为SDL2的Windows平台主函数封装机制：SDL2main库提供了标准main函数的包装层，要求用户代码的入口函数必须匹配SDL指定的签名，或者通过宏告知SDL不接管主函数逻辑。

修复方案 #

1. 调整主函数签名或定义宏 #

两种可选方式二选一：

• 方式一：改用SDL指定的主函数签名
  修改代码中的主函数为SDL要求的形式：

  #include <SDL.h>
  
  int SDL_main(int argc, char* argv[]) {
      // 初始化SDL及业务逻辑
      SDL_Init(SDL_INIT_VIDEO);
      // ... 你的代码
      SDL_Quit();
      return 0;
  }
  

• 方式二：保留标准main函数，定义宏跳过SDL接管
  在包含SDL头文件之前定义SDL_MAIN_HANDLED宏：

  #define SDL_MAIN_HANDLED
  #include <SDL.h>
  
  int main(int argc, char* argv[]) {
      SDL_Init(SDL_INIT_VIDEO);
      // ... 你的代码
      SDL_Quit();
      return 0;
  }
  

2. 优化CMake配置（推荐） #

当前CMake配置可简化，无需手动指定头文件目录，因为SDL2的目标已包含必要路径：

include(FetchContent)
set(FETCHCONTENT_QUIET NO)

set(SDL2_VERSION 2.30)
FetchContent_Declare(
    SDL2
    GIT_REPOSITORY      https://github.com/libsdl-org/SDL
    GIT_TAG             release-2.30.0
    OVERRIDE_FIND_PACKAGE
)
FetchContent_MakeAvailable(SDL2)

# 使用PRIVATE关键字明确依赖范围，无需手动include_directories
target_link_libraries(${PROJECT_NAME} PRIVATE SDL2::SDL2main SDL2::SDL2-static)

3. 清理重建 #

删除旧构建目录后重新执行构建命令：

rm -rf build
cmake -B build -G "MinGW Makefiles"
cd build && make

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