如何解决CMake通过FetchContent引入SDL2与SDL2_Image的报错问题？

错误原因分析 #

1. SDL2_image的CMake脚本期望SDL2目标被正确导出，但默认FetchContent引入SDL2时，未配置相关导出选项，导致SDL2_image无法正确依赖SDL2目标。
2. 手动添加include目录的方式错误：${SDL2IMAGE_INCLUDE_DIRS}/include属于冗余路径，且全局include_directories不如目标级包含更规范。
3. 未显式启用SDL2_image的静态库构建，导致SDL2_image::SDL2_image-static目标不存在。

修正后的CMake配置 #

cmake_minimum_required(VERSION 3.24)
project(sdl_test)

set(CMAKE_CXX_STANDARD 20)

# 强制构建静态库，统一依赖类型
set(BUILD_SHARED_LIBS OFF)

include(FetchContent)
set(FETCHCONTENT_QUIET FALSE)

FetchContent_Declare(
        SDL2
        GIT_REPOSITORY https://github.com/libsdl-org/SDL.git
        GIT_TAG release-2.26.3
        GIT_SHALLOW TRUE
        GIT_PROGRESS TRUE
)
# 配置SDL2的安装路径，确保导出信息正确
set(SDL2_INSTALL_PREFIX ${CMAKE_CURRENT_BINARY_DIR}/SDL2_install)
set(CMAKE_INSTALL_PREFIX ${SDL2_INSTALL_PREFIX} CACHE PATH "" FORCE)
FetchContent_MakeAvailable(SDL2)

FetchContent_Declare(
        SDL2_image
        GIT_REPOSITORY https://github.com/libsdl-org/SDL_image.git
        GIT_TAG release-2.6.3
        GIT_SHALLOW TRUE
        GIT_PROGRESS TRUE
)
# 显式启用SDL2_image静态库构建，并指定SDL2的位置
set(SDL2IMAGE_STATIC ON CACHE BOOL "" FORCE)
set(SDL2IMAGE_SDL2_DIR ${SDL2_SOURCE_DIR} CACHE PATH "" FORCE)
FetchContent_MakeAvailable(SDL2_image)

add_executable(sdl_test main.cpp)
# 链接目标，无需手动添加include目录，目标会自动传递依赖的include路径
target_link_libraries(sdl_test PRIVATE SDL2::SDL2main SDL2::SDL2-static SDL2_image::SDL2_image-static)

关键修改点说明 #

• 设置BUILD_SHARED_LIBS OFF：统一构建静态库，避免动态/静态库混合依赖的问题。
• 为SDL2指定安装前缀：确保SDL2的导出配置被正确生成，让SDL2_image能找到SDL2的目标信息。
• 启用SDL2IMAGE_STATIC：明确告诉SDL2_image构建静态库，生成SDL2_image::SDL2_image-static目标。
• 指定SDL2IMAGE_SDL2_DIR：直接指向已通过FetchContent获取的SDL2源码目录，避免SDL2_image再去寻找系统中的SDL2。
• 移除全局include_directories：改用目标链接时自动传递的include路径，更符合CMake的现代用法。

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