CMake链接libngt时出现未定义引用错误求助

问题分析 #

出现undefined reference错误的核心原因是编译器无法找到代码调用函数的对应实现符号，常见诱因包括：头文件与已安装libngt版本不匹配、CMake链接配置不规范、项目编译选项（如C++标准）与libngt不一致、链接顺序错误等。

解决方案 #

1. 校验头文件与libngt版本匹配性 #

检查代码中引入的libngt头文件，确保其与/usr/local/include/ngt下的头文件版本一致：

• 打开/usr/local/include/ngt/Index.h，查看NGT::Index::open和createGraphAndTree的函数签名
• 如果头文件中函数参数数量/类型与代码调用的不一致，说明代码使用的是旧版本接口，需调整代码适配当前libngt版本，或重新安装对应版本的libngt

2. 改用规范的CMake库查找方式 #

避免手动使用link_directories，改用更可靠的自动查找方式：

方式一：使用find_library

修改CMakeLists.txt如下：

cmake_minimum_required(VERSION 3.0 FATAL_ERROR)
project(blksim_test)

find_package(Torch REQUIRED)
# 精准查找libngt库
find_library(NGT_LIBRARY NAMES ngt PATHS /usr/local/lib NO_DEFAULT_PATH)

add_executable(test_sim test_sim.cc hash_network.cc hash_pool.cc)
target_include_directories(test_sim PRIVATE ../include)
# 链接依赖库
target_link_libraries(test_sim PRIVATE "${TORCH_LIBRARIES}" ${NGT_LIBRARY})
set_property(TARGET test_sim PROPERTY CXX_STANDARD 14)

方式二：使用pkg-config（推荐）

若libngt支持pkg-config，可通过以下配置自动处理头文件与库路径：

cmake_minimum_required(VERSION 3.0 FATAL_ERROR)
project(blksim_test)

find_package(Torch REQUIRED)
find_package(PkgConfig REQUIRED)
# 通过pkg-config自动识别libngt的依赖信息
pkg_check_modules(NGT REQUIRED ngt)

add_executable(test_sim test_sim.cc hash_network.cc hash_pool.cc)
target_include_directories(test_sim PRIVATE ../include ${NGT_INCLUDE_DIRS})
target_link_libraries(test_sim PRIVATE "${TORCH_LIBRARIES}" ${NGT_LIBRARIES})
set_property(TARGET test_sim PROPERTY CXX_STANDARD 14)

3. 统一C++编译标准 #

libngt编译时使用的C标准可能与项目不一致，导致ABI兼容性问题。尝试将项目C标准调整为与libngt一致（libngt通常使用C++17）：

set_property(TARGET test_sim PROPERTY CXX_STANDARD 17)

4. 直接链接静态库排除动态库问题 #

若动态库存在符号缺失，可直接链接静态库libngt.a：

target_link_libraries(test_sim PRIVATE "${TORCH_LIBRARIES}" /usr/local/lib/libngt.a)

5. 验证库中是否存在目标符号 #

使用nm命令检查libngt库是否包含缺失的符号：

# 检查open函数符号
nm -D /usr/local/lib/libngt.so | grep "_ZN3NGT5Index4openERKSsbb"
# 检查createGraphAndTree函数符号
nm -D /usr/local/lib/libngt.so | grep "_ZN3NGT5Index18createGraphAndTreeERKSsRNS_8PropertyEbPKcmb"

若输出为空，说明符号确实不在库中，需重新安装完整版本的libngt。

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