如何解决Python3.8环境中OpenCV导入路径错误指向C盘的问题？

问题背景 #

系统已存在Python 2.7及另一环境的Python 3.7（已安装OpenCV），为满足需求在D盘的miniforge3中创建了Python 3.8独立环境，安装OpenCV后出现导入错误：

ImportError: cannot import the name '_registerMatType' from 'cv2.cv2' (c:\python38\lib\site-packages\cv2\cv2.cp38-win_amd64.pyd)

错误路径指向C盘的Python 3.8目录，而非D盘的conda环境，这是导致问题的核心原因。

解决方案 #

1. 确认当前环境的Python路径 #

激活Python38环境后，执行命令检查当前Python解释器的调用路径：

where python

正常输出应仅包含D盘miniforge3环境下的Python路径，若同时出现C盘路径，说明环境变量优先级异常。

2. 调整系统环境变量优先级 #

• 打开系统「环境变量」设置，找到Path系统变量
• 将D:\mypath\miniforge3\envs\Python38及D:\mypath\miniforge3\envs\Python38\Scripts移至Path列表的最顶端
• 重启终端，再次执行where python确认仅显示conda环境的路径

3. 清理C盘Python 3.8的OpenCV残留 #

若C盘存在独立安装的Python 3.8（非conda环境），可直接卸载该版本；若需保留，手动删除C盘Python目录下的OpenCV相关文件：

• 删除C:\python38\lib\site-packages下的cv2文件夹
• 删除所有以opencv-开头的文件夹及.dist-info目录

4. 重新安装OpenCV（可选） #

确保环境路径正确后，先卸载已安装的OpenCV包：

pip uninstall opencv-python opencv-contrib-python opencv-python-headless -y

再重新安装所需版本（建议只安装一个OpenCV包，避免冲突）：

pip install opencv-python

5. 验证修复结果 #

在激活的Python38环境中启动Python交互终端，执行以下代码验证：

import cv2
print(cv2.__version__)
print(cv2.__file__)

确认输出的文件路径为D盘conda环境下的cv2文件，且版本显示正常。

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