使用SWIG生成.pyd文件失败，求助链接错误等相关问题

问题背景 #

我在Windows 11 64位系统上手动编译SWIG官方文档示例，涉及example.i、example.c、example.h三个文件，执行以下步骤后遇到错误：

• 执行swig -python example.i，生成example_wrap.c和example.py；
• 执行gcc -O2 -fPIC -c example.c，生成example.o；
• 执行gcc -O2 -fPIC -c example_wrap.c -I"D:\Program Files\Python310\include"，生成example_wrap.o；
• 执行gcc -shared example.o example_wrap.o -o _example.so时，出现大量Python相关符号的未定义引用错误。

咨询以下问题：

1. 这属于链接错误吗？
2. D:\Program Files\Python310\libs下的python3.lib和python310.lib有何区别，应使用哪一个？
3. 如何在gcc中链接.lib文件？

问题解答 #

1. 是否属于链接错误？ #

是，这是典型的链接阶段错误。链接器合并目标文件时，找不到example_wrap.o中引用的Python相关函数/符号的定义——这些定义存在于Python的库文件中，但当前链接命令未引入对应库，因此报错。

2. python3.lib和python310.lib的区别及选择 #

• python3.lib是通用导入库，属于“桩文件”，本身不包含实际符号，仅转发指向对应版本的具体库；
• python310.lib是Python 3.10版本的具体导入库，包含该版本Python的所有导出符号定义。

编译Python扩展时必须使用对应版本的具体库，也就是python310.lib，通用库无法精准匹配你的Python版本，会导致链接失败。

3. gcc中链接.lib文件的方法 #

在gcc链接命令中，用-L参数指定库文件所在目录，用-l参数指定库名（需去掉.lib后缀）。针对你的场景，修改后的链接命令应为：

gcc -shared example.o example_wrap.o -L"D:\Program Files\Python310\libs" -lpython310 -o _example.pyd

注意：Windows平台下Python扩展的后缀应为.pyd而非.so，.so是类Unix系统的后缀，.pyd才能被Python正确识别加载。

内容的提问来源于stack exchange，提问作者Kishore Kumar S