Python导入C扩展模块失败时，如何定位缺失的依赖库？

当Python加载C扩展模块（比如.pyd文件）时，哪怕模块文件明明存在，还是会抛出模糊的错误：

>>> import mymodule
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ImportError: DLL load failed while importing mymodule: The specified module could not be found.

这是因为Python只是直接转发了Windows的DLL加载错误，没法直接告诉你到底缺了哪个依赖。下面是通用的排查步骤：

• 用Dependency Walker工具分析
  直接下载运行Dependency Walker，把目标.pyd文件拖进工具界面。工具会自动扫描所有依赖的DLL，找不到的文件会标红显示。注意：部分系统级DLL（比如api-ms-win-*.dll）的“缺失”可能是工具兼容性问题，重点关注模块专属的第三方依赖就行。

• 用Windows自带的dumpbin命令列依赖
  打开Visual Studio开发者命令提示符（或者先把dumpbin加到系统PATH里），执行命令：

  dumpbin /dependents mymodule.pyd
  

  输出会列出模块所有依赖的DLL，挨个检查这些DLL是否在Python的搜索路径里——包括当前工作目录、系统PATH路径、Python安装目录等。

• 用Python的ctypes手动验证依赖
  在Python交互环境里，手动尝试加载怀疑缺失的DLL：

  import ctypes
  # 把下面的文件名换成dumpbin列出的依赖DLL
  ctypes.WinDLL("missing_dll.dll")
  

  如果加载失败，会抛出更具体的错误，方便定位问题。

• 检查PATH环境变量
  确保所有依赖DLL所在的目录已经加到系统或用户的PATH里。Python加载DLL时会优先搜当前工作目录、系统PATH、Python安装目录以及site-packages下的相关路径，也可以临时加路径测试：

  import os
  os.environ["PATH"] += ";C:\\path\\to\\dll\\directory"
  import mymodule
  

• 用Process Monitor追踪加载过程
  运行Process Monitor，设置过滤条件：进程名称选python.exe，操作包含Load Image。然后执行import mymodule命令，看日志里的加载失败记录，就能找到具体缺失的DLL文件名。

补充：以上都是通用方案，适用于Windows平台下所有Python C扩展模块的依赖排查，不用针对特定包调整。

内容的提问来源于stack exchange，提问作者Diego Sánchez