pybind11链接静态/动态库时出现ImportError: undefined symbol问题求助

问题根源 #

GCC链接器遵循命令行顺序优先的规则：当处理静态库（.a）或动态库（.so）时，只有当前存在未解析的符号引用时，才会从库中提取对应的目标文件或链接符号。

你之前的编译命令中，libadd.a放在my_add.cpp之前：

g++ ... libadd.a my_add.cpp ...

此时链接器先处理libadd.a，但还没有来自my_add.cpp的add函数引用，所以会跳过库中的add.o，最终生成的共享库中不包含add的实现，导致运行时找不到符号。而直接链接.o文件时，链接器会无条件包含该文件的内容，因此不会出现问题。

静态库的修复方案 #

调整编译命令的顺序，将静态库放在引用它的源文件之后：

g++ -Wall -shared -std=c++11 -fPIC $(python3 -m pybind11 --includes) my_add.cpp libadd.a -o my_add$(python3-config --extension-suffix)

动态库的修复方案 #

1. 正确编译动态库 #

确保编译动态库时添加-fPIC参数（生成位置无关代码）：

g++ -c -fPIC add.cpp -o add.o
g++ -shared add.o -o libadd.so

2. 调整链接顺序 #

同样将库的引用放在源文件之后，如果库不在系统标准路径（如/usr/lib），需要用-L指定库路径：

# 如果libadd.so在当前目录
g++ -Wall -shared -std=c++11 -fPIC $(python3 -m pybind11 --includes) my_add.cpp -L. -ladd -o my_add$(python3-config --extension-suffix)

# 如果已放入/usr/lib，可省略-L参数
g++ -Wall -shared -std=c++11 -fPIC $(python3 -m pybind11 --includes) my_add.cpp -ladd -o my_add$(python3-config --extension-suffix)

验证方法 #

可以用nm命令检查生成的共享库是否包含目标符号：

nm my_add$(python3-config --extension-suffix) | grep _Z3addii

修复后应该能看到类似0000000000001129 T _Z3addii的输出，说明符号已成功包含。

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