CMake链接错误：可执行文件引用自定义库函数未定义

你的未定义引用错误核心原因是可执行文件未与自定义库mylib建立链接关系，同时CMake配置中存在多处语法和用法错误，以下是具体修复步骤：

原配置的关键错误点 #

• 可执行文件未通过target_link_libraries关联mylib，导致无法找到Game类的实现代码
• target_include_directories误用：既传入了单个头文件路径而非目录，又错误地将库名、SDL库路径混入头文件目录参数
• add_executable中无需显式添加头文件，CMake会自动处理头文件依赖
• link_directories属于冗余操作，现代CMake推荐使用目标式链接替代
• 全局命令include_directories与目标命令混用，破坏了构建的模块化隔离

正确的CMakeLists.txt配置 #

cmake_minimum_required(VERSION 3.23)
project(game)

# 强制启用C++14标准，避免编译器自动降级
set(CMAKE_CXX_STANDARD 14)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 创建自定义静态库，包含game.cpp实现与头文件（头文件仅用于IDE识别）
add_library(mylib STATIC src/game.cpp include/game.h)
# 为库指定头文件目录，PUBLIC意味着链接该库的目标会自动继承此目录
target_include_directories(mylib PUBLIC ${PROJECT_SOURCE_DIR}/include)

# 创建可执行文件，仅需添加源文件（main.cpp）
add_executable(${PROJECT_NAME} src/main.cpp)

# 核心步骤：将自定义库链接到可执行文件
target_link_libraries(${PROJECT_NAME} PRIVATE mylib)

# 查找SDL2与SDL2_image依赖
include(FindPkgConfig)
pkg_search_module(SDL2 REQUIRED sdl2)
pkg_search_module(SDL2IMAGE REQUIRED SDL2_image>=2.0.0)

# 链接SDL库到可执行文件
target_link_libraries(${PROJECT_NAME} PRIVATE ${SDL2_LIBRARIES} ${SDL2IMAGE_LIBRARIES})
# 添加SDL的头文件目录（pkg_search_module已自动处理，此处为显式兜底）
target_include_directories(${PROJECT_NAME} PRIVATE ${SDL2_INCLUDE_DIRS} ${SDL2IMAGE_INCLUDE_DIRS})

关键配置说明 #

1. 自定义库与可执行文件的链接：通过target_link_libraries(${PROJECT_NAME} PRIVATE mylib)，可执行文件才能找到game.cpp中的Game类实现，解决未定义引用问题。
2. 头文件目录管理：为mylib设置PUBLIC类型的头文件目录，确保所有链接该库的目标（如主程序）无需重复配置include路径即可找到game.h。
3. SDL库的正确使用：pkg_search_module会自动获取SDL的头文件和库路径，通过target_link_libraries将其链接到主程序即可，无需手动指定链接目录。

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