链接C++动态库libutilities.so时出现未定义引用错误求助

问题根源 #

生成共享库时使用gcc（C编译器）链接C目标文件，导致C标准库依赖缺失、名称修饰（name mangling）不兼容，最终触发未定义引用错误。

解决方案 #

1. 重新生成兼容的共享库 #

修改生成共享库的bash脚本，将链接命令从gcc替换为g++：

cd $HOME/myproject
# 重新编译目标文件（可选，确保编译链一致）
g++ -I./inc -fPIC -c -o utilities.o src/utilities.cpp
# 用g++链接生成符合C++规范的共享库
g++ -shared -o libutilities.so utilities.o
mv libutilities.so lib/
mv utilities.o lib/

2. 验证库中的符号 #

用nm命令检查共享库是否包含正确的readFromCSV符号：

nm -D $HOME/myproject/lib/libutilities.so | grep readFromCSV

若输出包含类似_ZN8myproject11readFromCSVERKNSt7__cxx1112basic_stringIcSt11char_traitsIcESaIcEEEiRSt3mapIiSt6vectorIS3_SaIS3_EESaISt4pairIKiS6_EESt4lessIiESaISD_EE的符号，说明库的符号符合C++名称修饰规则，与main.cpp的符号需求匹配。

3. 确保main.cpp的编译环境一致 #

编译main.cpp必须使用g++，保证C++编译链统一：

# 先编译main.cpp为目标文件
g++ -c -o main.o -I$HOME/myproject/inc main.cpp
# 链接生成可执行文件
g++ -o main main.o -L$HOME/myproject/lib -lutilities

额外检查点 #

• 确认main.cpp正确引入utilities.hpp，且readFromCSV调用处于myproject命名空间下（代码中using namespace myproject;已满足要求）。
• 若运行时提示找不到库，可临时设置库路径：

export LD_LIBRARY_PATH=$HOME/myproject/lib:$LD_LIBRARY_PATH
./main

或通过修改/etc/ld.so.conf并执行ldconfig实现永久生效。

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