CMake：未定义的引用

Question

我使用 CMake 3.5.2。尝试构建我的 C++ 代码时，出现以下错误：

[100%] Linking CXX executable SomeExecutable
CMakeFiles/SomeExecutable.dir/Common/src/FunctionOne.cpp.o: In function `FunctionOne::FunctionOne(std::__cxx11::basic_string<char, std::char_traits<char>, std::allocator<char> >, double, double, unsigned int, bool)':
FunctionOne.cpp:(.text+0x490): undefined reference to `Helper::initLevel(std::__cxx11::basic_string<char, std::char_traits<char>, std::allocator<char> > const&, bool)'

程序在 myLib.so 中找不到 Helper::initLevel()。我该如何解决？

CMakeLists.txt：（为简洁而缩短）

cmake_minimum_required(VERSION 3.0)
project(ProjectName)

add_definitions(-std=c++11)
add_definitions(-Wall)
add_definitions(-O2)

link_directories(/usr/local/lib)    

add_executable(SomeExecutable SomeExecutable.cpp ${FunctionOne} ${FunctionTwo})
target_link_libraries(SomeExecutable -pthread -lboost_thread ${Boost_LIBRARIES} myLib armadillo)

文件结构（为简洁起见）：

├── bin
├── CMakeCache.txt
├── cmake_install.cmake
├── CMakeLists.txt
├── Common
│   ├── include
│   │   ├── dataContainer.h
│   │   ├── FunctionOne.h
│   │   ├── FunctionTwo.h
│   └── src
│       ├── FunctionOne.cpp
│       └── FunctionTwo.cpp
├── SomeExecutable.cpp
├── myLib
│   ├── example.cpp
│   ├── include
│   │   ├── Config.h
│   │   ├── Helper.h
│   ├── libmyLib.so

更新：

myLib/include/Config.h：

Namespace Helper {
[...]
    Level* initLevel(const std::string& jsonLvlPath, bool twiceSpatPts =        false);
[..]
}

更新 2：

kepj@laptop:~/ProjectName$ make VERBOSE=1
/usr/bin/cmake -E cmake_link_script CMakeFiles/SomeExecutable.dir/link.txt --verbose=1
/usr/bin/c++      CMakeFiles/SomeExecutable.dir/SomeExecutable.cpp.o CMakeFiles/SomeExecutable.dir/Common/src/FunctionOne.cpp.o CMakeFiles/SomeExecutable.dir/Common/src/FunctionTwo.cpp.o SomeExecutable  -L/usr/local/lib -rdynamic -pthread -lboost_thread -lboost_system -lboost_filesystem -lmyLib -lsymbolicc++ -lmatio -larmadillo -Wl,-rpath,/usr/local/lib 
CMakeFiles/SomeExecutable.dir/Common/src/FunctionTwo.cpp.o: In function `FunctionTwo::FunctionTwo(std::__cxx11::basic_string<char, std::char_traits<char>, std::allocator<char> >, double, double, unsigned int, bool)':
FunctionTwo.cpp:(.text+0x490): undefined reference to `Helper::initLevel(std::__cxx11::basic_string<char, std::char_traits<char>, std::allocator<char> > const&, bool)'
collect2: error: ld returned 1 exit status
CMakeFiles/SomeExecutable.dir/build.make:174: recipe for target 'SomeExecutable' failed
make[2]: *** [SomeExecutable] Error 1
make[2]: Leaving directory '/home/kepj/ProjectName'
CMakeFiles/Makefile2:67: recipe for target 'CMakeFiles/SomeExecutable.dir/all' failed
make[1]: *** [CMakeFiles/SomeExecutable.dir/all] Error 2
make[1]: Leaving directory '/home/kepj/ProjectName'
Makefile:83: recipe for target 'all' failed
make: *** [all] Error 2

Answer 1

所以从技术上讲，关于这个问题的信息仍然不足以肯定地回答这个问题，但我将分享我将如何调试这个问题，只知道问题中的内容，并解释沿途的每一步。

确保您链接到正确的myLib.so

这个解释性很好，是我对这个问题根源的最佳猜测。

相关编译器标志：-L/usr/local/lib -lmyLib

当试图找到您在编译命令中使用-l 参数指定的库时，链接器会执行一系列步骤： 1. 它查看传递给-l 的参数是绝对路径（到库的整个路径，即在*nix 计算机上以/ 开头，在Windows 上以驱动器号开头）还是只是一个名称。如果它是绝对路径，那么它知道它在哪里。在这种情况下，它只是一个名称，因此请继续执行第 2 步。 2. 下一个要查看的地方是-L 参数中指定的路径。在这种情况下，唯一的-L 参数是/usr/local/lib，所以它看起来在那里。对于这种特定情况，这可能是也可能不是。查看您的文件系统以查看文件/usr/local/lib/libmyLib.so 是否存在，如果存在，请确保该版本是最近的版本。 3. 现在搜索configured linker paths。对每个路径使用与第 2 步相同的步骤。

这是我的猜测，因为您的链接器参数中没有引用您的 myLib 文件夹，但您声称它在该文件夹中，所以我认为它使用的是过时的 myLib.so。

确保.so 或.a 文件实际上具有未定义的符号

在 linux 上，你可以list the symbols defined in a .so file。确保解析为 undefined 的符号在那里。

如果它们不存在，可能的原因如下：

1. 您没有使用所有 C++ 源文件 (.cpp) 来创建您的库。
2. 定义和声明不匹配：
   1. 定义函数前忘记输入namespace Helper
   2. 你拼错了函数名
   3. 参数/返回类型不匹配
   4. 对于成员函数，您忘记在函数名称前包含MyClass::。

ABI 不匹配

（感谢 cmets 中的 n.m 指出这一点）

由于 C++ 标准库有多种实现（和版本），您可能会遇到 ABI 不匹配。

这意味着myLib 编译时使用的标准库与您尝试编译可执行文件的标准库不兼容。例如，当您在 linux 上使用 libstdc++ 编译 myLib，然后转到 mac 并尝试编译您的可执行文件，其中标准库是 libc++，您会出错。为什么？任何东西的签名，例如std::string 是不一样的。它们是完全不同的类，在链接时会导致签名不匹配。