【C++】link error

最近在编译一个项目时，在一台机器上能编译过去，而在另一台机器上出现了link error。下面是一些总结。

当你在编译C++程序时，经常会遇到链接器错误（Linker Errors）。这些错误通常发生在编译器尝试将多个源文件编译成可执行文件时，因为它们无法找到或解析某些符号或函数的定义。本文将介绍一些常见的C++链接器错误以及如何解决它们。

### 1. 未定义的符号（Undefined Symbol）

这是最常见的链接器错误之一。它表示编译器找不到对某些函数或变量的定义。通常是因为你使用了某个函数或变量，但没有在代码中提供相应的实现或声明。

**解决方法：**

- 确保你的源文件中包含了所有需要的头文件，并且已经正确实现了所有使用的函数和变量。
- 检查你的函数和变量命名是否正确，包括大小写和拼写错误。
- 如果你使用了外部库或框架，确保已经正确链接这些库，并且在编译时能够找到它们的头文件和库文件。

### 2. 重复的符号（Multiple Definitions）

这种错误表示同一个符号在多个源文件中被定义了多次。这可能是因为你在多个源文件中包含了同一个头文件，导致了函数或变量的多重定义。

**解决方法：**

- 确保你的头文件有适当的预处理指令，以防止多次包含。
- 如果你的函数或变量需要在多个文件中使用，使用`extern`关键字进行声明，然后在单个源文件中进行定义。

### 3. 缺少库文件（Missing Library）

这种错误表示编译器无法找到需要链接的库文件。这可能是因为你在编译时没有正确指定库文件的路径或名称。

**解决方法：**

- 确保你在编译命令中包含了正确的库文件路径和名称。
- 检查你的库文件是否正确安装，并且路径是否正确添加到编译器的搜索路径中。

### 4. 符号重命名（Symbol Renaming）

在C++中，函数和变量的名称在编译时可能会被重命名，以避免与其他库或对象中的相同名称冲突。如果编译器无法正确解析重命名后的符号，将会导致链接器错误。

**解决方法：**

- 如果你在不同的源文件中使用了相同的函数或变量名，并且这些源文件将被链接在一起，确保它们都使用相同的名称。
- 如果你使用了外部库或框架，并且出现了符号重命名的问题，尝试在编译时使用`extern "C"`来禁止C++名称修饰。

### 5. 不匹配的ABI（Mismatched ABI）

如果你的程序包含多个源文件，它们是使用不同的编译器选项或不同版本的C++标准编译的，可能会导致ABI（Application Binary Interface）不匹配，进而导致链接器错误。此种错误一般会是一些std::string and std::list 错误，我所遇到的就是此原因出错。

**解决方法：**

- 确保所有源文件使用相同的编译器选项和C++标准。
- 如果你使用了外部库，确保它们是使用相同的ABI构建的，并且与你的程序兼容。

参考：

https://gcc.gnu.org/onlinedocs/libstdc++/manual/using_dual_abi.html