You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

安装mediapipe后cv2导入报错无法正常使用如何修复

报错根因

环境中同时存在两个版本不匹配的OpenCV安装包:opencv-python 4.5.3.56与opencv-contrib-python 4.6.0.66。两个包共用cv2模块命名空间,版本不一致时加载逻辑冲突,就会触发属性缺失、循环导入类报错,该问题是安装mediapipe时自动拉取的依赖版本,与之前手动安装的OpenCV版本不兼容导致的。

修复操作步骤
  • 完全卸载当前环境下所有OpenCV相关包,连续执行两条卸载命令避免残留:
pip uninstall opencv-python -y
pip uninstall opencv-contrib-python -y
  • 安装版本完全匹配的OpenCV包,选择和mediapipe 0.8.10兼容、之前可以正常调用摄像头的4.5.3.56版本即可:
pip install opencv-python==4.5.3.56 opencv-contrib-python==4.5.3.56
  • 验证修复:打开Python交互终端执行import cv2,无报错即修复完成,可正常开展手部追踪程序开发。

注意:后续升级OpenCV时必须保证opencv-python和opencv-contrib-python两个包版本号完全一致,禁止单独升级其中某一个,否则会再次触发同类冲突。

内容的提问来源于stack exchange,提问作者015_Aris Mahmudi

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.02 03:01:16