如何诊断Windows下virtualenv中Python模块导入的DLL加载失败错误？

首先可以明确：这绝对不是virtualenv的bug，问题出在OpenCV预编译包依赖的系统级运行库缺失，或者这些库没有被Python的加载路径识别到。下面是具体的定位和解决步骤：

一、定位缺失的DLL文件 #

方法1：使用Dependency Walker工具 #

1. 找到你的虚拟环境中cv2的核心pyd文件，路径大概是：c:\src\venv\tf\lib\site-packages\cv2\cv2.cp36-win_amd64.pyd（文件名会根据Python版本和架构略有不同）
2. 下载并打开Dependency Walker，把这个pyd文件拖入工具窗口
3. 工具会扫描所有依赖的DLL，标记出红色的条目就是缺失的文件。注意：Win10及以上系统中，工具可能会误报一些系统核心DLL（如api-ms-win-*系列），忽略这些，重点看带有具体名称的缺失库（比如vcruntime140.dll这类）

方法2：用Python的ctypes模块排查 #

运行以下脚本（替换成你的pyd文件路径），会直接抛出具体的缺失DLL名称：

import ctypes
try:
    ctypes.WinDLL("c:/src/venv/tf/lib/site-packages/cv2/cv2.cp36-win_amd64.pyd")
except Exception as e:
    print(e)

二、常见解决方案 #

1. 安装Visual C++ Redistributable运行库 #

OpenCV的预编译包（包括opencv-python）依赖Microsoft Visual C++ Redistributable for Visual Studio 2015/2017/2019/2022，你需要下载对应你Python架构的版本（你的Python是64位，所以选x64版本）安装。安装完成后重启终端，重新激活虚拟环境再尝试导入cv2。

2. 手动添加DLL路径到系统PATH #

如果确认缺失的是某个特定DLL：

• 找到该DLL所在的系统路径（比如安装完VC Redist后，vcruntime140.dll通常在C:\Windows\System32或C:\Windows\SysWOW64，对应64/32位）
• 把这个路径添加到系统环境变量PATH中，或者临时添加到Python的路径里：

import sys
sys.path.append("C:/Windows/System32")
import cv2

3. 复制缺失DLL到虚拟环境目录 #

把缺失的DLL文件直接复制到虚拟环境的Scripts文件夹下（比如c:\src\venv\tf\Scripts\），这个目录默认在Python的加载路径中，重启Python后就能识别到。

内容的提问来源于stack exchange，提问作者Paul Du Bois