CMake中FetchContent引入多依赖的配置问题求助

你的问题核心是不同库的CMake支持程度不一致：SDL3自带完善的CMake配置，能自动生成SDL3::SDL3这类标准导入目标；但GLEW、ImGui、RapidJSON要么CMake支持不完善，要么需要手动配置导入目标，导致IDE无法识别、代码需写绝对路径。

以下是统一的依赖管理框架，能解决所有问题且方便后续添加新依赖：

第一步：统一基础配置 #

先在CMakeLists最开头定义版本、初始化基础设置：

cmake_minimum_required(VERSION 3.16)
project(YourProjectName)

# 定义所有依赖的版本（可按需修改）
set(SDL3_VERSION "3.0.0")
set(GLEW_VERSION "2.2.0")
set(IMGUI_VERSION "1.90.4")
set(RAPIDJSON_VERSION "1.1.0")

第二步：逐个处理依赖 #

针对每个库的特性，完善FetchContent配置并生成CMake可识别的导入目标：

1. SDL3（保持原有逻辑，简化平台判断） #

SDL3自带完整CMake支持，无需额外配置：

find_package(SDL3 ${SDL3_VERSION} QUIET)
if(NOT SDL3_FOUND)
    include(FetchContent)
    FetchContent_Declare(
        SDL3
        URL https://github.com/libsdl-org/SDL/archive/refs/tags/preview-${SDL3_VERSION}.tar.gz
        # 可选：添加SHA256哈希校验，避免下载损坏
        # URL_HASH SHA256=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    )
    # CMake会自动处理跨平台解压，无需分Win/Unix
    FetchContent_MakeAvailable(SDL3)
endif()

2. GLEW（使用带CMake支持的分支） #

官方GLEW的CMake支持较差，改用glew-cmake分支，自动生成GLEW::GLEW目标：

find_package(GLEW ${GLEW_VERSION} QUIET)
if(NOT GLEW_FOUND)
    include(FetchContent)
    FetchContent_Declare(
        GLEW
        URL https://github.com/Perlmint/glew-cmake/archive/refs/tags/${GLEW_VERSION}.tar.gz
        # URL_HASH SHA256=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    )
    FetchContent_MakeAvailable(GLEW)
endif()

3. ImGui（手动创建静态库目标） #

ImGui无官方CMake配置，需手动添加源文件并生成目标：

# ImGui无系统包，直接用FetchContent
include(FetchContent)
FetchContent_Declare(
    imgui
    URL https://github.com/ocornut/imgui/archive/refs/tags/v${IMGUI_VERSION}.tar.gz
    # URL_HASH SHA256=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
)
FetchContent_MakeAvailable(imgui)

# 创建ImGui静态库目标
add_library(imgui STATIC
    ${imgui_SOURCE_DIR}/imgui.cpp
    ${imgui_SOURCE_DIR}/imgui_demo.cpp
    ${imgui_SOURCE_DIR}/imgui_draw.cpp
    ${imgui_SOURCE_DIR}/imgui_tables.cpp
    ${imgui_SOURCE_DIR}/imgui_widgets.cpp
    # 若需SDL3+OpenGL后端，添加以下文件
    ${imgui_SOURCE_DIR}/backends/imgui_impl_sdl3.cpp
    ${imgui_SOURCE_DIR}/backends/imgui_impl_opengl3.cpp
)

# 配置ImGui的依赖和头文件路径
target_include_directories(imgui PUBLIC
    ${imgui_SOURCE_DIR}
    ${imgui_SOURCE_DIR}/backends  # 若用了后端需添加
)
target_link_libraries(imgui PUBLIC SDL3::SDL3 GLEW::GLEW)

4. RapidJSON（头文件库，创建INTERFACE目标） #

RapidJSON纯头文件，无需编译，只需配置include路径：

find_package(RapidJSON ${RAPIDJSON_VERSION} QUIET)
if(NOT RapidJSON_FOUND)
    include(FetchContent)
    FetchContent_Declare(
        RapidJSON
        URL https://github.com/Tencent/rapidjson/archive/refs/tags/v${RAPIDJSON_VERSION}.tar.gz
        # URL_HASH SHA256=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    )
    FetchContent_MakeAvailable(RapidJSON)

    # 创建INTERFACE目标，让CMake识别
    add_library(RapidJSON INTERFACE)
    target_include_directories(RapidJSON INTERFACE ${rapidjson_SOURCE_DIR}/include)
endif()

第三步：统一链接依赖 #

现在所有依赖都有了标准CMake目标，直接链接即可，无需手动设置include目录：

target_link_libraries(${PROJECT_NAME} PUBLIC
    SDL3::SDL3
    GLEW::GLEW
    imgui
    RapidJSON
)

关键注意事项 #

• IDE识别：配置完成后，需重新加载IDE的CMake项目（比如VSCode执行CMake: Reload CMake Project），IDE才能识别新的导入目标。
• 哈希校验：建议为每个FetchContent添加URL_HASH参数，确保源码下载完整，避免网络问题导致的编译错误。
• 扩展新依赖：后续添加其他库时，只需遵循以下逻辑：
  1. 优先尝试find_package查找系统已安装版本
  2. 找不到则用FetchContent下载源码
  3. 若库无CMake支持，手动创建STATIC/INTERFACE目标并配置include/链接依赖

内容的提问来源于stack exchange，提问作者Ewan Duplessis Kergomard