如何让CMake在项目非根目录下找到SDL库？

问题根源 #

CMake会缓存之前的配置信息，旧路径缓存可能导致SDL2_PATH修改后不生效；同时直接使用相对路径可能因构建目录的不同，导致CMake解析路径出错。

具体解决步骤 #

1. 清理CMake缓存
   直接删除CLion生成的cmake-build-debug（或对应构建类型的目录），然后重新加载CMake配置，彻底清除旧路径缓存。

2. 正确设置SDL2路径
   使用CMAKE_SOURCE_DIR拼接绝对路径，确保CMake能准确定位libs目录下的SDL2。修改后的CMake代码如下：

   cmake_minimum_required(VERSION 3.23)
   project(game)
   set(CMAKE_CXX_STANDARD 23)
   
   set(CMAKE_MODULE_PATH ${CMAKE_SOURCE_DIR}/cmake/modules)
   # 基于项目根目录拼接SDL2的完整路径
   set(SDL2_PATH "${CMAKE_SOURCE_DIR}/libs/SDL2-2.26.4/x86_64-w64-mingw32")
   
   find_package(SDL2 REQUIRED)
   # 推荐使用target级别的头目录设置，替代全局include_directories
   add_executable(game src/main.cpp)
   target_include_directories(game PRIVATE ${SDL2_INCLUDE_DIR})
   
   target_link_libraries(game ${SDL2_LIBRARY})
   

3. 备选方案：手动指定路径（如果FindSDL2.cmake模块失效）
   如果第三方FindSDL2.cmake模块无法识别SDL2_PATH，可以直接手动指定头文件和库文件路径：

   cmake_minimum_required(VERSION 3.23)
   project(game)
   set(CMAKE_CXX_STANDARD 23)
   
   set(SDL2_INCLUDE_DIR "${CMAKE_SOURCE_DIR}/libs/SDL2-2.26.4/x86_64-w64-mingw32/include")
   set(SDL2_LIBRARY "${CMAKE_SOURCE_DIR}/libs/SDL2-2.26.4/x86_64-w64-mingw32/lib/libSDL2main.a"
                    "${CMAKE_SOURCE_DIR}/libs/SDL2-2.26.4/x86_64-w64-mingw32/lib/libSDL2.a")
   
   add_executable(game src/main.cpp)
   target_include_directories(game PRIVATE ${SDL2_INCLUDE_DIR})
   # MinGW环境下需要额外链接系统依赖库
   target_link_libraries(game ${SDL2_LIBRARY} winmm imm32 version)
   

4. 验证文件结构
   确保libs目录下的SDL2结构符合预期：

   game/
   ├── cmake/
   │   └── modules/
   │       └── FindSDL2.cmake
   ├── libs/
   │   └── SDL2-2.26.4/
   │       └── x86_64-w64-mingw32/
   │           ├── include/
   │           │   └── SDL2/
   │           │       └── （所有SDL头文件）
   │           └── lib/
   │               ├── libSDL2main.a
   │               ├── libSDL2.a
   │               └── （其他SDL库文件）
   ├── src/
   │   └── main.cpp
   └── CMakeLists.txt
   

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