Windows 11 Pro下导入cv2时出现DLL加载失败错误

错误回溯信息（中文翻译） #

Traceback (most recent call last):
  File ...\桌面\heatmap\heatmapp.py", line 2, in <module>
    import cv2
  File "C:\Users\MikailAkdeniz\AppData\Local\Programs\Python\Python312\Lib\site-packages\cv2\__init__.py", line 181, in <module>
    bootstrap()
  File "C:\Users\MikailAkdeniz\AppData\Local\Programs\Python\Python312\Lib\site-packages\cv2\__init__.py", line 153, in bootstrap
    native_module = importlib.import_module("cv2")
                    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\MikailAkdeniz\AppData\Local\Programs\Python\Python312\Lib\importlib\__init__.py", line 90, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ImportError: DLL加载失败: 找不到指定的模块。

推荐解决方案 #

• 检查并修复Visual C++运行库
  OpenCV依赖Microsoft Visual C++ Redistributable组件，可能是组件损坏或缺失导致DLL加载失败。下载并安装对应版本的Microsoft Visual C++ Redistributable for Visual Studio 2022，完成后重启电脑再测试。

• 重新安装匹配版本的OpenCV
  现有OpenCV安装文件可能损坏，或版本与Python 3.12兼容性出现问题。执行以下步骤：

  1. 卸载当前OpenCV：

     pip uninstall opencv-python
     

  2. 重新安装指定版本：

     pip install opencv-python==4.10.0.84
     

• 添加OpenCV DLL路径到系统环境变量
  找到Python安装目录下的C:\Users\MikailAkdeniz\AppData\Local\Programs\Python\Python312\Lib\site-packages\cv2\python-3.12文件夹，将该路径添加到系统PATH环境变量中。添加完成后重启命令行或IDE，再运行代码。

• 用虚拟环境隔离测试
  原有Python环境可能被其他软件篡改，创建全新虚拟环境排查问题：

  python -m venv cv2_test_env
  cv2_test_env\Scripts\activate
  pip install opencv-python==4.10.0.84
  

  在该虚拟环境中运行代码，若正常则说明原有环境存在异常，需清理或重置。

• 修复系统损坏文件
  使用Windows自带工具修复系统文件：

  1. 以管理员身份打开命令提示符
  2. 执行命令：

     sfc /scannow
     

  扫描修复完成后重启电脑，再测试导入cv2。

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