Windows7虚拟环境下OpenCV读取外部avi文件返回空帧求助

我之前也碰到过一模一样的情况！在Windows 7的Python虚拟环境里，用OpenCV读取笔记本摄像头完全正常，但读本地AVI文件时总是返回空帧，核心问题就是OpenCV依赖的视频解码DLL没被系统找到——哪怕你已经用pip装好了opencv-python，虚拟环境的隔离性会导致系统找不到这些库文件。

下面是针对虚拟环境的具体解决步骤：

• 定位虚拟环境中的OpenCV DLL目录
  打开你的虚拟环境文件夹，找到这条路径：你的虚拟环境名\Lib\site-packages\cv2\python-3.6（比如你的虚拟环境叫venv，那就是venv\Lib\site-packages\cv2\python-3.6）。进去后你会看到一堆以opencv_ffmpeg开头的DLL文件，对应3.4.1版本的应该是opencv_ffmpeg341_64.dll（64位系统）或者不带_64的32位版本。

• 临时添加路径（无需重启系统）
  如果你不想修改系统环境变量，可以在Python脚本开头加入这段代码，临时把DLL目录加入系统路径，这样运行脚本时就能加载到解码库了：

  import sys
  import os
  
  # 替换成你自己的虚拟环境opencv DLL路径
  opencv_dll_dir = r"C:\path\to\your\venv\Lib\site-packages\cv2\python-3.6"
  sys.path.append(opencv_dll_dir)
  # 更新系统PATH环境变量，让Windows能找到DLL
  os.environ['PATH'] = opencv_dll_dir + ';' + os.environ['PATH']
  
  import cv2
  
  # 尝试读取视频文件
  cap = cv2.VideoCapture("video.avi")
  if not cap.isOpened():
      print("视频文件无法打开，请检查路径或文件完整性！")
  else:
      while cap.isOpened():
          ret, frame = cap.read()
          if ret:
              cv2.imshow('Video Frame', frame)
              # 按q键退出
              if cv2.waitKey(25) & 0xFF == ord('q'):
                  break
          else:
              break
      cap.release()
      cv2.destroyAllWindows()
  

• 永久添加路径（一劳永逸）
  要是你不想每次写脚本都加这段代码，可以把DLL目录添加到Windows系统环境变量里：

  1. 右键「计算机」→「属性」→「高级系统设置」→「环境变量」
  2. 在「系统变量」列表里找到PATH，点击「编辑」
  3. 把你的OpenCV DLL路径粘贴进去，用分号和已有的路径隔开
  4. 点击确定保存，然后重启你的命令行或IDE，环境变量就会生效了

• 额外排查小提示

  • 确认video.avi的路径正确：要么用绝对路径，要么把视频文件放在脚本同一个文件夹里
  • 检查视频文件本身是否损坏：用普通播放器（比如PotPlayer、Windows Media Player）打开试试能不能正常播放
  • 匹配Python和OpenCV的位数：如果你装的是32位Python，要确保opencv-python也是32位版本，对应的DLL文件也不能带_64后缀

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