Python OpenCV报cv2无face属性 安装contrib包仍无效如何解决

该报错核心原因是LBPH人脸识别器所属的face模块属于OpenCV扩展模块，未随主程序默认加载。安装opencv-contrib-python后仍报错，按以下步骤逐一排查：

• 全量卸载所有OpenCV相关安装包，消除多包冲突。多版本共存、不同渠道（pip/conda）混装、安装headless无界面版本都会导致扩展模块加载失败，终端执行以下命令反复卸载，直到提示无对应安装包为止：

# 卸载pip渠道安装的所有OpenCV变体
pip uninstall -y opencv-python opencv-contrib-python opencv-python-headless opencv-contrib-python-headless
# 如果你曾用conda安装过OpenCV，额外执行卸载命令
conda uninstall -y opencv

• 安装版本完全匹配的OpenCV主包与扩展包。必须保证opencv-python和opencv-contrib-python的版本号完全一致，否则扩展模块无法被主包识别加载，推荐安装兼容性较好的稳定版本：

pip install opencv-python==4.8.0.76 opencv-contrib-python==4.8.0.76

注意：如果使用venv/conda虚拟环境运行代码，必须先激活对应虚拟环境再执行安装命令，否则包会被写入全局Python路径，当前运行环境无法读取。

• 安装完成后执行基础校验，打开Python交互终端运行以下代码，确认模块正常加载：

import cv2
# 打印当前加载的OpenCV版本，确认和刚安装的版本一致
print(cv2.__version__)
# 测试LBPH识别器创建
face_recognizer = cv2.face.LBPHFaceRecognizer_create()
print("识别器创建成功，模块加载正常")

• 如果校验仍失败，排查两类高频低级错误：
  • 检查你的代码文件、同目录下是否存在命名为cv2.py的文件，如果有立刻改名，同时删除同目录下的__pycache__缓存文件夹——Python会优先导入当前目录下的同名文件，覆盖真正的OpenCV库。
  • 检查VS Code、PyCharm等编辑器选中的Python解释器，是否和你刚才执行安装命令的解释器路径一致，解释器不匹配是新手最容易忽略的环境问题。

补充：如果你使用的是3.x及更早的老旧OpenCV版本，LBPH识别器的创建API为cv2.createLBPHFaceRecognizer()，但该版本已停止维护，优先推荐使用4.x稳定版本。

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