CMakeLists配置问题：SDL3静态链接失败且SDL3.dll缺失

问题根源 #

SDL3的CMake默认仅构建动态库，未启用静态库目标；同时现有配置存在目录路径错误（实际目录为vendor/，但配置中写的是lib/），导致静态库目标SDL3::SDL3-static无法被识别，且动态库未自动复制到可执行文件运行目录。

具体修复步骤 #

1. 修正目录路径 #

将配置中所有lib/替换为vendor/，匹配实际项目目录结构。

2. 启用SDL3静态库构建 #

在add_subdirectory(SDL)之前添加CMake选项，强制SDL编译为静态库。

3. 添加静态链接必要宏 #

静态链接SDL时，需定义SDL_STATIC宏，避免动态库相关的编译错误。

4. 改用目标级包含目录（可选但推荐） #

替代全局include_directories，使用target_include_directories仅将包含目录应用到目标项目，避免全局污染。

修改后的完整CMakeLists.txt #

cmake_minimum_required (VERSION 3.12)

project ("app")

# 定义包含目录
set(APP_INCLUDE_DIRS
    "${CMAKE_SOURCE_DIR}/include"
)

set(IMGUI_INCLUDE_DIRS
    "${CMAKE_SOURCE_DIR}/vendor/imgui"
    "${CMAKE_SOURCE_DIR}/vendor/imgui/backends"
)

# 定义源文件
set(APP_SOURCES
    "${CMAKE_SOURCE_DIR}/source/app.cpp"
)

set(IMGUI_SOURCES
    "${CMAKE_SOURCE_DIR}/vendor/imgui/imgui.cpp"
    "${CMAKE_SOURCE_DIR}/vendor/imgui/imgui_demo.cpp"
    "${CMAKE_SOURCE_DIR}/vendor/imgui/imgui_draw.cpp"
    "${CMAKE_SOURCE_DIR}/vendor/imgui/imgui_tables.cpp"
    "${CMAKE_SOURCE_DIR}/vendor/imgui/imgui_widgets.cpp"
    "${CMAKE_SOURCE_DIR}/vendor/imgui/backends/imgui_impl_sdl3.cpp"
    "${CMAKE_SOURCE_DIR}/vendor/imgui/backends/imgui_impl_opengl3.cpp"
)

# 强制SDL3构建静态库
set(SDL_STATIC ON CACHE BOOL "Build SDL3 as static library" FORCE)
set(SDL_ROOT "${CMAKE_SOURCE_DIR}/vendor/SDL")
add_subdirectory("${SDL_ROOT}" EXCLUDE_FROM_ALL)

find_package(OpenGL REQUIRED)

# 添加可执行文件目标
add_executable (app ${APP_SOURCES} ${IMGUI_SOURCES})

# 设置目标专属包含目录
target_include_directories(app PRIVATE
    ${APP_INCLUDE_DIRS}
    ${IMGUI_INCLUDE_DIRS}
    ${OPENGL_INCLUDE_DIRS}
)

# 定义静态链接所需宏
target_compile_definitions(app PRIVATE SDL_STATIC)

# 链接静态库及依赖
target_link_libraries(app PRIVATE SDL3::SDL3-static ${OPENGL_LIBRARIES})

关键修改说明 #

• set(SDL_STATIC ON CACHE BOOL ... FORCE)：强制SDL的CMake构建系统生成静态库目标SDL3::SDL3-static。
• 替换lib/为vendor/：修复文件路径不匹配问题，确保CMake能正确找到SDL和ImGui的源码。
• target_compile_definitions(app PRIVATE SDL_STATIC)：告知SDL头文件当前使用静态链接，禁用动态库的导出/导入宏，避免编译错误。
• 使用target_include_directories：仅将包含目录应用到app目标，符合CMake现代最佳实践，减少全局配置冲突。

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