CMake构建C项目链接阶段报函数未定义编译失败问题求助

错误核心原因 #

链接阶段抛出testeint函数未定义引用，本质是两个配置问题：

• 项目根目录缺少顶层CMake配置文件，主程序和libs下的静态库构建流程完全独立，执行make时根本不会触发libteste静态库的编译
• 主程序CMake配置仅添加了库头文件搜索路径，没有将编译生成的静态库链接到可执行文件目标

分步修复配置 #

1. 新增项目根目录顶层CMakeLists.txt #

在testcompila根目录下新建CMakeLists.txt，统一管控子项目构建顺序，内容如下：

cmake_minimum_required(VERSION 3.12)
project(testecompila
        VERSION 0.0.1
        DESCRIPTION "Teste compilação"
        LANGUAGES C)

# 优先构建依赖静态库，再构建主程序
add_subdirectory(libs/src)
add_subdirectory(src)

2. 修改libs/src目录下的CMakeLists.txt #

删除冗余的重复项目声明、无效配置，给静态库绑定公开头文件路径，修改后内容：

# 声明静态库目标
add_library(libteste STATIC testelib.c)
# 配置头文件搜索路径，PUBLIC属性会让链接该库的目标自动继承此路径
target_include_directories(libteste PUBLIC ${CMAKE_SOURCE_DIR}/libs/include)

删除原有配置中重复的cmake_minimum_required、project声明、强制设置C语言属性、默认/usr/include路径、链接器verbose参数等冗余内容，CMake会自动识别C源码、默认加载系统头文件路径。

3. 修改src目录下的CMakeLists.txt #

删除冗余配置，添加静态库链接逻辑，修改后内容：

# 声明可执行文件目标
add_executable(testecompila teste.c)
# 配置可执行文件输出目录
set_target_properties(testecompila PROPERTIES RUNTIME_OUTPUT_DIRECTORY ${CMAKE_SOURCE_DIR}/src/bin)
# 链接依赖的静态库，头文件路径会从libteste的配置自动继承，无需重复写include_directories
target_link_libraries(testecompila PRIVATE libteste)

标准构建流程 #

先清理之前子目录下生成的旧Makefile、CMake缓存文件，在项目根目录执行外构建命令，避免污染源码目录：

mkdir build && cd build
cmake ..
make

构建完成后可执行文件会生成在src/bin目录下，可直接运行，不会再出现链接错误。

原有配置的其他注意事项 #

• 优先使用target_include_directories、target_link_libraries等带目标作用域的配置命令，不要用全局的include_directories，避免跨目标路径污染
• 跨目录路径不要写../这类相对路径，使用CMake内置的CMAKE_SOURCE_DIR（项目根目录绝对路径）变量，避免切换构建目录时路径失效
• 子目录不需要重复声明cmake_minimum_required和project()，统一在顶层配置即可

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