使用Makefile构建pybind11项目时出现PyInstanceMethod_Type未定义错误

核心问题 #

编译时未链接Python运行时库，PyInstanceMethod_Type属于Python C API中的符号，必须链接Python库才能完成符号解析。

具体修复步骤 #

1. 获取Python链接参数
   执行Python自带的配置工具，获取正确的链接选项：

   python3-config --ldflags
   

   输出示例（依系统和Python版本略有差异）：

   -L/usr/lib/python3.8/config-3.8-x86_64-linux-gnu -L/usr/lib -lpython3.8 -lcrypt -lpthread -ldl  -lutil -lm
   

2. 修改Makefile的LDFLAGS
   将上述命令的输出追加到你的LDFLAGS末尾，确保链接Python库。修改后的代码片段：

   LDFLAGS=$(LIBPATH)/libstrategystudio_analytics.a $(LIBPATH)/libstrategystudio.a $(LIBPATH)/libstrategystudio_transport.a $(LIBPATH)/libstrategystudio_marketmodels.a $(LIBPATH)/libstrategystudio_utilities.a $(LIBPATH)/libstrategystudio_flashprotocol.a `python3-config --ldflags`
   

   注意用反引号`包裹命令，让Makefile自动执行并获取输出内容。

3. 可选：补全编译参数
   可以用以下命令检查并补全INCLUDES参数，确保Python头文件路径完整：

   python3-config --cflags
   

   输出示例：

   -I/usr/include/python3.8 -I/usr/include/x86_64-linux-gnu/python3.8 -Wno-unused-result -Wsign-compare -DNDEBUG -g -fwrapv -O2 -Wall -g -fstack-protector-strong -Wformat -Werror=format-security -g -fwrapv -O2
   

额外提示 #

• 若系统存在多个Python版本，建议用对应版本的配置工具，比如python3.8-config --ldflags，避免版本冲突。
• 链接顺序需注意，Python库最好放在依赖链末尾，确保所有依赖Python符号的目标文件能正确找到定义。

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