如何用CMake正确链接C++模块？测试遇未定义符号错误求助

问题重现 #

运行单元测试时触发链接器错误：

[build] ld: Undefined symbols:
[build]  ConfigStore::addValue(std::__1::basic_string<char, std::__1::char_traits<char>
...
[build] clang: error: linker command failed with exit code 

核心问题与修复方案 #

1. 测试程序未链接依赖库 #

你的test目录CMakeLists仅配置了头文件路径和库搜索目录，但未将测试可执行文件与ConfigStore库绑定，也未处理Singleton的依赖。修改test/CMakeLists.txt：

# 创建测试可执行文件
add_executable(ConfigStoreTest ConfigStore_test.cpp)

# 链接gtest框架与ConfigStore库
target_link_libraries(ConfigStoreTest PRIVATE
    gtest_main
    ConfigStore
)

# 配置头文件目录（推荐用target级别的配置替代全局include）
target_include_directories(ConfigStoreTest PRIVATE
    ${CMAKE_CURRENT_SOURCE_DIR}/googletest/include
    ${CMAKE_SOURCE_DIR}/Infrastructure/ConfigStore
    ${CMAKE_SOURCE_DIR}/Infrastructure/Singleton
)

2. 模板类Singleton的实现位置错误 #

C++模板类的成员函数实现必须放在头文件中（或显式实例化），否则编译器无法生成具体类型的代码。将Singleton.cpp的内容移至Singleton.h末尾：

// Singleton.h 末尾补充实现
#include <memory>

template<typename T>
T& Singleton<T>::instance(){
    static const std::unique_ptr<T> instance{new T{typename Singleton<T>::token{}}};
    return *instance;
}

随后删除Singleton.cpp文件，避免重复编译冲突。

3. 构造函数参数不匹配 #

Singleton的instance方法中用new T{}构造对象，但ConfigStore的构造函数需要token参数。修改Singleton的instance实现（如上代码所示），确保传入正确的构造参数。

4. 头文件拼写不一致 #

代码中存在头文件名拼写错误：

• ConfigStore.h中写#include "../Singleton/Singleton_H"
• 测试文件中写#include "ConfigStore_H"
  统一修正为实际文件名（如Singleton.h和ConfigStore.h），避免编译时无法找到正确的类声明。

5. 根目录CMakeLists的小问题 #

根目录中target_link_libraries(${PROJECT_NAME} PUBLIC ConfigStore)的${PROJECT_NAME}需与add_library(BinanceAPI BinanceAPI.cpp)的库名一致，直接写BinanceAPI更清晰：

target_link_libraries(BinanceAPI PUBLIC ConfigStore)

验证步骤 #

1. 清理原有构建目录，重新运行CMake配置
2. 编译项目，链接器错误应消失，单元测试可正常执行

内容的提问来源于stack exchange，提问作者Aymane EL Jahrani