Python3.9安装opencv-contrib-python后无法使用cv2功能如何解决

• 先确认环境匹配：执行python --version和pip --version，确认当前调用的Python和pip都是对应3.9版本，避免多环境下包安装到其他Python版本，存在版本不一致时使用python3.9 -m pip替代所有pip命令
• 重装兼容版本的OpenCV包：先执行pip uninstall -y opencv-python opencv-contrib-python卸载所有已安装的opencv相关包，再执行python3.9 -m pip install opencv-contrib-python==4.5.5.62，该版本对Python3.9的适配性更稳定
• 补充系统依赖：
  • Windows系统：安装VC++ 2015-2022 Redistributable运行库，缺失该运行库会直接导致cv2导入失败
  • Debian/Ubuntu系统：执行sudo apt install -y libgl1-mesa-glx libglib2.0-0安装底层图形依赖
  • macOS系统：执行brew install opencv补充系统级依赖
• 排除命名冲突：检查你的工作目录下是否存在名为cv2.py的文件，该文件名会和官方库冲突导致导入错误，修改为其他名称即可
• 校验安装结果：执行python3.9 -c "import cv2; print(cv2.__version__)"，正常输出版本号即说明问题解决

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