Windows下使用Swig执行ld命令报错，无法生成.so文件求助

问题背景 #

你在Windows系统使用Swig工具，已完成配置并生成.o文件，但执行ld命令生成.so文件时出现大量未定义引用错误，典型错误如下：

ld: example_wrap.o:example_wrap.c:(.text+0x58): undefined reference to __imp__Py_Dealloc' ld: example_wrap.o:example_wrap.c:(.text+0x18e): undefined reference to strlen'

你执行的命令序列：

swig -python example.i
gcc -c example.c example_wrap.c -I C:\Users\Administrator\AppData\Local\Programs\Python\Python38\include
ld -shared example.o example_wrap.o -o _example.so

核心原因 #

1. 未链接Python依赖库：__imp__Py_Dealloc这类错误是因为链接器找不到Python的导入库，没有将Python运行时的符号纳入链接过程。
2. 标准库依赖未处理：strlen这类C标准库函数报错，是因为直接用ld链接时不会自动关联C标准库，而gcc会自动处理这部分依赖。
3. 后缀不符合Windows规范：Windows平台的Python扩展标准后缀是.pyd，而非类Unix系统的.so，虽然部分场景下.so能被识别，但推荐遵循标准格式。

修复步骤 #

步骤1：替换链接工具，用gcc完成链接 #

直接使用gcc执行链接操作，它会自动处理C标准库的依赖，同时显式指定Python的库文件和路径：

gcc -shared example.o example_wrap.o -L C:\Users\Administrator\AppData\Local\Programs\Python\Python38\libs -lpython38 -o _example.pyd

参数说明：

• -L：指定Python库文件所在的目录
• -lpython38：链接对应版本的Python库（根据你的Python版本调整，比如Python3.9就是-lpython39）
• -o _example.pyd：生成符合Windows规范的Python扩展文件

步骤2：处理Python库缺失的情况 #

如果你的Python安装目录libs下没有对应的.a静态库（MinGW需要的格式），可以通过以下命令生成：

1. 生成Python的def文件：

gendef C:\Users\Administrator\AppData\Local\Programs\Python\Python38\python38.dll

2. 用dlltool生成静态库：

dlltool -d python38.def -l libpython38.a

3. 将生成的libpython38.a放到Python的libs目录，或者在链接命令中指定该文件的路径。

步骤3：验证结果 #

生成_example.pyd后，在Python环境中尝试导入example模块，若能成功导入并调用相关函数，说明问题已解决。

额外注意事项 #

• 确保gcc的架构（32位/64位）与Python的编译架构完全一致，否则会出现链接失败或导入错误。

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