CMake链接SDL2_image与SDL2_ttf异常：可执行文件无法渲染图文

可能原因1：CMake未正确处理SDL2_image/SDL2_ttf的依赖链 #

虽然CMake检测到了.so文件，但如果没使用官方标准的链接方式，可能只链接了库本身，没带上它们的依赖（比如SDL2_image依赖的png/jpeg库、SDL2_ttf依赖的freetype库）。而旧Makefile可能手动指定了所有依赖项，所以能正常运行。

解决步骤 #

1. 改用SDL2官方CMake模块的标准写法
   别手动设置链接路径，用find_package和命名空间目标来链接，自动处理依赖链：

   # 查找SDL2及相关库（需确保安装了对应开发包）
   find_package(SDL2 REQUIRED)
   find_package(SDL2_image REQUIRED)
   find_package(SDL2_ttf REQUIRED)
   
   # 定义你的可执行文件
   add_executable(your_project main.cpp [其他源文件])
   
   # 链接所有SDL2相关库
   target_link_libraries(your_project 
       PRIVATE 
       SDL2::SDL2 
       SDL2_image::SDL2_image 
       SDL2_ttf::SDL2_ttf
   )
   

2. 确认安装完整的开发包
   部分发行版的SDL2扩展库分运行时和开发版，只有开发版包含CMake配置文件和完整依赖。以Debian/Ubuntu为例，执行：

   sudo apt-get install libsdl2-image-dev libsdl2-ttf-dev
   

可能原因2：运行时动态库路径缺失 #

CMake生成的可执行文件可能找不到SDL2_image/SDL2_ttf的动态库，虽然CMake配置阶段能找到，但运行时系统动态链接器检索不到。

解决步骤 #

1. 检查依赖加载情况
   用ldd命令查看可执行文件的依赖：

   ldd ./your_project
   

   看libSDL2_image.so和libSDL2_ttf.so是否显示not found。
2. 修复运行时路径
   • 临时解决：运行前设置环境变量：

     LD_LIBRARY_PATH=/你的SDL库路径 ./your_project
     

   • 永久解决：在CMake中添加rpath配置，让可执行文件记住库路径：

     set(CMAKE_INSTALL_RPATH_USE_LINK_PATH TRUE)
     # 或者手动指定路径
     target_link_options(your_project PRIVATE "-Wl,-rpath,/自定义SDL库路径")
     

可能原因3：CMake链接的库版本与Makefile不一致 #

如果CMake用的是系统默认的旧版本SDL2扩展库，而Makefile用的是你自己编译的新版本，可能出现API不兼容，导致渲染失败。

解决步骤 #

1. 对比库路径
   查看旧Makefile里指定的SDL2_image/SDL2_ttf路径，和CMakeCache.txt里的路径是否一致。如果不一致，在CMake中手动指定：

   set(SDL2_IMAGE_INCLUDE_DIRS /自定义SDL2_image/include路径)
   set(SDL2_IMAGE_LIBRARIES /自定义SDL2_image/lib/libSDL2_image.so)
   set(SDL2_TTF_INCLUDE_DIRS /自定义SDL2_ttf/include路径)
   set(SDL2_TTF_LIBRARIES /自定义SDL2_ttf/lib/libSDL2_ttf.so)
   

2. 验证库版本
   用命令查看库版本，对比两个环境的版本是否一致：

   objdump -p /path/to/libSDL2_image.so | grep Version
   

最后验证 #

修改CMakeLists.txt后，彻底清理旧构建目录重新生成：

rm -rf build && mkdir build && cd build
cmake .. && make

运行时开启SDL调试输出，查看隐藏错误：

SDL_DEBUG=1 ./your_project

调试信息会输出加载图片/字体时的具体问题，方便进一步定位。

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