已安装opencv-python但运行代码import cv2提示ModuleNotFoundError如何解决？
2026-10-10
解决方案
这个错误绝大多数场景是你安装opencv的Python环境，和你实际运行代码的Python环境不是同一个，结合你当前使用conda的base环境的情况，按以下步骤操作即可解决：
步骤1：确认当前运行的Python环境
执行以下命令查看你执行代码用的Python3的实际路径和版本：
which python3 python3 --version
确认返回的版本是你正在使用的Python 3.6.8。
步骤2：检查对应环境是否安装了opencv-python
不要直接用pip list查询，要调用当前Python对应的pip来查询，避免匹配到其他环境的pip：
python3 -m pip list | grep opencv
如果返回结果里没有opencv-python，说明你之前的安装是装到了其他Python环境下。
步骤3：为当前Python环境安装匹配版本的opencv-python
Python 3.6最高支持的opencv-python版本为4.5.5.62，更高版本不再兼容Python 3.6，执行以下命令安装：
python3 -m pip install opencv-python==4.5.5.62
如果你更习惯用conda管理包，也可以执行conda命令安装：
conda install -c conda-forge opencv
注意：如果执行pip安装命令时提示权限不足，可在命令末尾追加
--user参数，安装到当前用户目录下即可。
步骤4：验证安装是否成功
执行以下命令，如果正常输出版本号说明安装成功，再运行你的代码即可：
python3 -c "import cv2; print(cv2.__version__)"
内容的提问来源于stack exchange，提问作者user16521419
相关产品推荐
相关产品推荐
