CMake项目混合链接INTERFACE与传统库及SDL2构建疑问

一、解决target_link_libraries签名冲突错误 #

错误原因：CMake对同一个目标的target_link_libraries调用要求要么全部使用关键字格式（带PUBLIC/PRIVATE/INTERFACE），要么全部使用普通格式，你之前混合了两种写法（先调用带INTERFACE关键字的版本，又调用不带关键字的版本），因此触发报错。

修正方法：统一使用关键字格式，根据依赖传递需求选择PUBLIC（依赖需暴露给engine的使用者）或PRIVATE（仅engine内部使用）：

# 替换原链接代码
find_package(OpenGL REQUIRED)
find_package(glfw3 REQUIRED)
find_package(GLUT REQUIRED)
find_package(GLEW REQUIRED)

# 无需手动收集INCLUDE_DIRS和LIBS，find_package生成的导入目标已包含这些信息
target_link_libraries(engine
    PUBLIC # 根据实际需求调整为PRIVATE/INTERFACE
        OpenGL::GL
        glfw
        GLUT::GLUT
        GLEW::GLEW
        SDL2
        STB_IMAGE
)

二、SDL2的INTERFACE库配置修正 #

你之前的SDL2 INTERFACE库仅添加了头文件目录，缺少链接库的配置，这就是传统方式链接时出现未定义引用的核心原因。根据SDL2的存放形式，分两种修正方式：

情况1：vendors/SDL2是预编译库（含include目录和编译好的库文件） #

需补充链接库的路径和具体库名（注意平台差异：Windows下为SDL2.lib/SDL2main.lib，Linux下为libSDL2.so）：

add_library(SDL2 INTERFACE)
# 指定头文件目录
target_include_directories(SDL2 INTERFACE ${CMAKE_CURRENT_SOURCE_DIR}/vendors/SDL2/include)
# 指定库文件所在目录
target_link_directories(SDL2 INTERFACE ${CMAKE_CURRENT_SOURCE_DIR}/vendors/SDL2/lib)
# 指定要链接的SDL2库（SDL2main是Windows下必需的入口库）
target_link_libraries(SDL2 INTERFACE SDL2 SDL2main)

情况2：vendors/SDL2是SDL2完整源码（自带CMakeLists.txt） #

直接用add_subdirectory导入SDL2源码构建，SDL2官方CMake会自动生成标准导入目标（如SDL2::SDL2）：

add_subdirectory(vendors/SDL2)
# 直接链接官方导出的目标即可，无需手动配置include和库路径
target_link_libraries(engine PUBLIC SDL2::SDL2 SDL2::SDL2main)

三、额外优化建议 #

• 优先使用CMake的导入目标（如OpenGL::GL、glfw），这些目标已封装了include目录、链接库、编译选项等信息，无需手动收集变量。
• 避免用target_include_directories手动添加依赖头文件，依赖的include目录会在target_link_libraries链接目标时自动传递。

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