Windows下VSCode Jupyter导入cv2遇空字节错误及重装失败求助

问题现象 #

在Windows系统的VSCode Jupyter环境中执行import cv2时，报错：

1 import os
----> 2 import cv2
      3 import matplotlib.pyplot as plt

ValueError: source code string cannot contain null bytes

尝试重新安装opencv-python时，卸载现有版本4.6.0.66过程中出现如下错误：

ERROR: Exception:
Installing collected packages: opencv-python
  Attempting uninstall: opencv-python
    Found existing installation: opencv-python 4.6.0.66
Traceback (most recent call last):
  File "C:\ProgramData\Anaconda3\lib\site-packages\pip\_internal\cli\base_command.py", line 160, in exc_logging_wrapper
    status = run_func(*args)
  File "C:\ProgramData\Anaconda3\lib\site-packages\pip\_internal\cli\req_command.py", line 247, in wrapper
    return func(self, options, args)
  File "C:\ProgramData\Anaconda3\lib\site-packages\pip\_internal\commands\install.py", line 494, in run
    installed = install_given_reqs(
  File "C:\ProgramData\Anaconda3\lib\site-packages\pip\_internal\req\__init__.py", line 68, in install_given_reqs
    uninstalled_pathset = requirement.uninstall(auto_confirm=True)
  File "C:\ProgramData\Anaconda3\lib\site-packages\pip\_internal\req\req_install.py", line 659, in uninstall
    uninstalled_pathset = UninstallPathSet.from_dist(dist)
  File "C:\ProgramData\Anaconda3\lib\site-packages\pip\_internal\req\req_uninstall.py", line 526, in from_dist
    for path in uninstallation_paths(dist):
  File "C:\ProgramData\Anaconda3\lib\site-packages\pip\_internal\req\req_uninstall.py", line 45, in unique
    for item in fn(*args, **kw):
  File "C:\ProgramData\Anaconda3\lib\site-packages\pip\_internal\req\req_uninstall.py", line 85, in uninstallation_paths
    for entry in entries:
  File "C:\ProgramData\Anaconda3\lib\site-packages\pip\_internal\metadata\base.py", line 472, in <genexpr>
    return (str(pathlib.Path(row[0])) for row in csv.reader(text.splitlines()))
_csv.Error: line contains NUL

解决方案 #

1. 手动清理损坏的opencv-python残留文件 #

• 定位到Anaconda的site-packages目录，默认路径为C:\ProgramData\Anaconda3\Lib\site-packages
• 删除所有与opencv相关的文件夹和文件，包括：
  • cv2文件夹
  • opencv-python-4.6.0.66.dist-info文件夹
  • 其他带opencv或cv2前缀的文件

2. 修复pip工具 #

• 右键点击Anaconda Prompt，选择以管理员身份运行
• 执行pip升级命令：

  python -m pip install --upgrade pip
  

• 如果升级后仍有问题，手动清理pip缓存：
  找到路径C:\Users\[你的用户名]\AppData\Local\pip\Cache，删除整个Cache文件夹

3. 重新安装opencv-python #

• 在管理员权限的Anaconda Prompt中执行安装命令：

  pip install opencv-python
  

• 若需要指定稳定版本，可执行：

  pip install opencv-python==4.8.0.76
  

4. 验证安装 #

在VSCode的Jupyter notebook中重新运行import cv2，确认无报错即可。

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