将SDL与SDL_image作为CMake子项目引入后运行程序出现断言失败的问题求助

我之前在子项目集成SDL和SDL_image的时候也碰到过一模一样的断言错误，本质原因是SDL_image和你的主程序没有使用同一个SDL运行时实例——虽然你把SDL编译成了静态库，但SDL_image默认可能还是去链接系统里的动态SDL库，或者编译时没有正确关联你项目里的SDL，导致运行时出现两套SDL内部结构，触发magic值校验失败。

下面是一步步的解决方案：

1. 修复CMake配置，让SDL_image正确依赖本地SDL静态库 #

修改testRepos/third_party/CMakeLists.txt，在添加SDL_image子项目前，明确告诉它使用我们本地编译的SDL，而不是系统的：

cmake_minimum_required (VERSION 3.8)
project(third_party)

add_subdirectory(SDL)
set(SDL_INCLUDE_DIR ${CMAKE_CURRENT_LIST_DIR}/SDL/include)

# 配置SDL_image的依赖，强制使用本地的SDL静态库
set(SDL2_IMAGE_SDL2_INCLUDE_DIRS ${SDL_INCLUDE_DIR})
set(SDL2_IMAGE_SDL2_LIBRARIES SDL2-static SDL2main)
# 可选：强制SDL_image编译为静态库，减少动态依赖
set(SDL2_IMAGE_BUILD_STATIC ON)
set(SDL2_IMAGE_BUILD_SHARED OFF)
# 只编译你需要的图片格式，比如仅PNG
set(SDL2_IMAGE_PNG ON)
set(SDL2_IMAGE_JPG OFF)
set(SDL2_IMAGE_WEBP OFF)

add_subdirectory(SDL_image)
set(SDL_IMAGE_INCLUDE_DIR ${CMAKE_CURRENT_LIST_DIR}/SDL_image/include)

这样SDL_image编译时会直接链接你项目里的SDL静态库，不会再去寻找系统版本。

2. 调整主程序的链接配置 #

修改testRepos/src/CMakeLists.txt，确保链接正确的库目标，并且包含SDL_image的头文件：

cmake_minimum_required (VERSION 3.8)
project(main)

add_executable (main main.cpp)

# 包含SDL和SDL_image的头文件目录
target_include_directories(main PUBLIC 
    ${SDL_INCLUDE_DIR} 
    ${SDL_IMAGE_INCLUDE_DIR}
)

# 链接静态库，注意顺序：依赖库在前，被依赖库在后
target_link_libraries(main 
    SDL2_image-static 
    SDL2-static 
    SDL2main
    # Windows下可能需要额外链接系统库，SDL会自动处理，但手动加上更保险
    winmm imm32 version
)

如果你选择编译SDL_image为动态库，把SDL2_image-static换成SDL2_image即可。

3. 自动复制动态库（可选，若使用动态编译） #

如果不想用静态库，让CMake自动把依赖的DLL复制到可执行文件目录，避免手动复制：

# 在src/CMakeLists.txt末尾添加
add_custom_command(TARGET main POST_BUILD
    COMMAND ${CMAKE_COMMAND} -E copy_if_different
    $<TARGET_FILE:SDL2>
    $<TARGET_FILE_DIR:main>
)

add_custom_command(TARGET main POST_BUILD
    COMMAND ${CMAKE_COMMAND} -E copy_if_different
    $<TARGET_FILE:SDL2_image>
    $<TARGET_FILE_DIR:main>
)

# 复制libpng和zlib的动态库（如果是动态编译的话）
add_custom_command(TARGET main POST_BUILD
    COMMAND ${CMAKE_COMMAND} -E copy_if_different
    $<TARGET_FILE:png16>
    $<TARGET_FILE_DIR:main>
)

add_custom_command(TARGET main POST_BUILD
    COMMAND ${CMAKE_COMMAND} -E copy_if_different
    $<TARGET_FILE:zlib>
    $<TARGET_FILE_DIR:main>
)

4. 修复代码中的初始化bug #

你的init()函数最后没有返回true！这会导致未定义行为——函数声明返回bool，但成功时没有返回值，可能会返回随机的false，甚至影响后续逻辑。必须在init()函数末尾添加：

return true;

做完这些修改后，重新构建项目，应该就能正常加载纹理并运行了。

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