Windows下使用SWIG+MinGW-w64绑定C++与Python时DLL加载失败如何解决

核心问题及修复方法 #

1. 移除冗余编译参数 #

-fpic是Linux平台生成位置无关代码的专属参数，Windows平台编译不需要该参数，直接删除第二道编译命令中的-fpic即可，修改后的编译命令如下：

g++ -c factorial.cpp
g++ -c factorial_wrap.cxx -IC:\Users\kritomas\AppData\Local\Programs\Python\Python38\include

2. 修复符号导出与运行时依赖问题 #

你遇到的DLL load failed报错90%以上来自两个底层问题：一是Windows下DLL默认不导出函数符号，二是MinGW默认动态链接自身运行时库，会导致pyd加载时找不到依赖的MinGW runtime DLL。
可以选择任意一种方案修复：

• 方案一（无侵入代码，推荐）：静态链接MinGW运行时，同时强制导出所有符号，修改链接命令如下：

g++ factorial.o factorial_wrap.o -LC:\Users\kritomas\AppData\Local\Programs\Python\Python38\libs -shared -static -static-libgcc -static-libstdc++ -Wl,--export-all-symbols -lpython38 -o _factorial.pyd

• 方案二：修改代码匹配extern "C"声明，你之前单独修改接口文件报undefined reference to 'fact'的原因是：C编译器会对未加extern "C"的函数做名称修饰，接口文件里的C风格声明找不到修饰后的C函数符号，需要两边同步修改：
  首先修改factorial.cpp的函数定义：

  extern "C" long fact(long num)
  {
      if (num <= 1) return 1;
      return num * fact(num - 1);
  }
  

  再修改factorial.i接口文件匹配声明：

  %module factorial
  %{
  extern "C" long fact(long num);
  %}
  extern "C" long fact(long num);
  

  修改完成后重新执行SWIG生成代码、编译、链接流程即可。

3. 架构匹配校验 #

必须保证MinGW-w64的架构与Python安装包架构完全一致：

• 若安装的是64位Python，必须使用x86_64版本的MinGW-w64
• 若安装的是32位Python，必须使用i686版本的MinGW-w64
  架构不匹配会直接导致DLL加载失败，哪怕编译过程无任何报错。

4. Python库兼容处理 #

官方Python默认安装的python38.lib是MSVC格式，MinGW可能无法正确识别，可手动生成MinGW兼容的导入库：

1. 从Python安装目录的DLLs文件夹中取出python38.dll
2. 执行以下命令生成libpython38.a：

gendef python38.dll
dlltool -d python38.def -l libpython38.a

3. 将生成的libpython38.a放入Python安装目录的libs文件夹中，再重新执行链接命令。

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