Windows VSCode下SDL2+CMake环境main函数无法运行的问题

问题根源 #

你的代码存在三个核心冲突点：

• 重复链接SDL2库：同时链接SDL2::SDL2-static和SDL2::SDL2，静态库与动态库的入口逻辑冲突，导致程序入口异常。
• SDL_MAIN_HANDLED与SDL2main冲突：既定义了SDL_MAIN_HANDLED（告知SDL不要接管main入口），又链接了SDL2::SDL2main（SDL会替换默认main为自己的入口函数），两者逻辑矛盾。
• 重复获取SDL2：先调用find_package(SDL2)，又通过FetchContent拉取SDL2源码编译，导致CMake环境中存在两个SDL2配置，引发链接混乱。

修正步骤 #

1. 修正CMakeLists.txt #

移除重复的库链接和无效的find_package调用，只保留FetchContent的SDL2配置：

cmake_minimum_required(VERSION 3.10)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

project(mygame)

# 直接包含外部依赖配置，不再重复find_package
include(${CMAKE_CURRENT_SOURCE_DIR}/external/external.cmake)
add_executable(mygame main.cpp)

# 二选一：要么链接SDL2main（不定义SDL_MAIN_HANDLED），要么只链接SDL2-static（定义SDL_MAIN_HANDLED）
# 方案1：使用SDL2main接管入口（推荐，SDL会处理平台相关初始化）
target_link_libraries(mygame PRIVATE SDL2::SDL2main SDL2::SDL2-static)

# 方案2：自己接管main入口（需定义SDL_MAIN_HANDLED）
# target_link_libraries(mygame PRIVATE SDL2::SDL2-static)

2. 修正main.cpp #

如果选择方案1（使用SDL2main），移除#define SDL_MAIN_HANDLED，SDL会自动处理入口，你的main会被SDL的包装函数调用：

#include <SDL.h>
#include <stdio.h>

int main(int args, char** argv)
{
    printf("Ready\n"); // 加换行确保输出立即刷新
    return 0;
}

如果选择方案2（自己接管入口），保留#define SDL_MAIN_HANDLED，但只链接SDL2-static，不链接SDL2main：

#define SDL_MAIN_HANDLED
#include <SDL.h>
#include <stdio.h>

int main(int args, char** argv)
{
    printf("Ready\n");
    return 0;
}

3. 简化external.cmake（可选） #

移除重复的cmake_minimum_required和不必要的CMAKE_MODULE_PATH设置：

include(FetchContent)
set(FETCHCONTENT_QUIET FALSE)
include(${CMAKE_CURRENT_SOURCE_DIR}/sdl2.cmake)

4. 清理编译缓存 #

删除build目录，重新运行CMake配置和编译，避免旧的冲突配置残留：

rm -rf build
mkdir build && cd build
cmake ..
make

额外提示 #

• 给printf添加换行符\n，确保输出能立即刷新到控制台（有些环境下无换行的输出会被缓冲，导致看不到）。
• 使用MinGW编译时，确保CMake正确识别了MinGW工具链，避免生成不兼容的可执行文件。

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