CMake项目中使用SDL2_ttf编译时头文件找不到问题求助

问题分析 #

核心问题是CMake能检测到SDL2_ttf包，但编译时无法找到SDL2/SDL_ttf.h，这大概率是CMake变量引用错误或者旧版CMake用法导致路径未正确传递。

解决方案 #

方案1：修正SDL2_ttf的CMake变量名 #

brew安装的SDL2_ttf对应的CMake查找模块，变量名通常是SDL2_TTF_INCLUDE_DIRS和SDL2_TTF_LIBRARIES（下划线分隔），而非你当前使用的SDL2TTF_INCLUDE_DIR和SDL2TTF_LIBRARY。修改后的CMakeLists.txt如下：

cmake_minimum_required(VERSION 3.5.0)
project(mygame VERSION 0.1.0 LANGUAGES C)

find_package(SDL2 REQUIRED)
find_package(SDL2_ttf REQUIRED)
# 修正变量名
include_directories(${SDL2_INCLUDE_DIRS} ${SDL2_TTF_INCLUDE_DIRS})

add_executable(mygame main.c
    classes/list/list.c
    classes/my_string/my_string.c
    classes/errors/errors.c
    classes/render/render.c
    classes/constants/constants.c
)
# 修正库变量
target_link_libraries(mygame PRIVATE ${SDL2_LIBRARIES} ${SDL2_TTF_LIBRARIES})

方案2：使用现代CMake导入目标（推荐） #

现代CMake更推荐直接使用导入目标，无需手动处理include目录和库路径，SDL2和SDL2_ttf的brew包已提供标准导入目标：

cmake_minimum_required(VERSION 3.5.0)
project(mygame VERSION 0.1.0 LANGUAGES C)

find_package(SDL2 REQUIRED)
find_package(SDL2_ttf REQUIRED)

add_executable(mygame main.c
    classes/list/list.c
    classes/my_string/my_string.c
    classes/errors/errors.c
    classes/render/render.c
    classes/constants/constants.c
)
# 直接链接导入目标，自动处理include路径和库依赖
target_link_libraries(mygame PRIVATE SDL2::SDL2 SDL2_ttf::SDL2_ttf)

验证步骤 #

1. 删除原build目录，重新执行cmake ..和编译命令，确保CMake重新生成配置
2. 若问题仍存在，可手动检查SDL2_ttf头文件位置：

   ls /opt/homebrew/include/SDL2/SDL_ttf.h
   

   确认文件存在后，可在CMakeLists.txt中手动添加路径测试：

   include_directories(/opt/homebrew/include)
   

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