CMake含子项目工程构建失败：链接出现undefined reference错误求助

问题描述 #

链接器报错，提示undefined reference to，错误与external/tui目录中定义的方法调用相关。

文件结构 #

-- root/
  -- CMakeLists.txt
  -- headers/
  -- src/
  -- external/
    -- tui/
      -- CMakeLists.txt
      -- headers/
      -- src/

现有CMake配置 #

根目录 CMakeLists.txt #

cmake_minimum_required(VERSION 3.27)

project(a.out VERSION 0.1 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
add_compile_options(-g)

file(GLOB HEADER_FILES headers/*.h)
file(GLOB SOURCE_FILES src/*.cpp)
add_subdirectory(external/tui)
add_executable(a.out ${HEADER_FILES} ${SOURCE_FILES})

target_link_libraries(a.out PRIVATE tui)

external/tui 目录 CMakeLists.txt #

cmake_minimum_required(VERSION 3.27)

project(tui)

find_package(Curses REQUIRED)

set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
add_compile_options(-g)

file(GLOB HEADER_FILES headers/*.h)
file(GLOB SOURCE_FILES src/*.cpp)
add_library(tui STATIC ${HEADER_FILES} ${SOURCE_FILES})

target_link_libraries(tui PRIVATE -lncurses)

错误原因及修复方案 #

1. 替换 file(GLOB) 为显式文件列表 #

file(GLOB) 无法自动识别新增文件，也可能漏掉子目录中的文件，导致部分方法实现未被编译进静态库。直接列出所有需要编译的文件：

比如修改tui目录的CMakeLists.txt：

# 替换原有file(GLOB)代码
set(HEADER_FILES
    headers/tui_core.h
    headers/tui_widgets.h  # 替换为实际头文件名
)
set(SOURCE_FILES
    src/tui_core.cpp
    src/tui_widgets.cpp  # 替换为实际源文件名
)

根目录的CMakeLists.txt同理，显式列出所有头文件和源文件。

2. 规范链接ncurses库 #

使用find_package(Curses REQUIRED)后，应借助CMake提供的${CURSES_LIBRARIES}变量链接库，而非手动写-lncurses。修改tui目录的CMakeLists：

# 替换原链接代码
target_link_libraries(tui PRIVATE ${CURSES_LIBRARIES})

3. 导出tui的头文件目录 #

在tui的CMakeLists.txt中添加头文件目录导出，让主程序编译时自动找到tui的头文件：

add_library(tui STATIC ${HEADER_FILES} ${SOURCE_FILES})
# 添加此行
target_include_directories(tui PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/headers)
target_link_libraries(tui PRIVATE ${CURSES_LIBRARIES})

4. 清理重建项目 #

修改配置后，删除旧构建文件重新编译：

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

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