自定义编译OpenCV 4.7.0的Python导入问题求助

核心原因 #

OpenCV 4.7.0调整了Python绑定的生成逻辑，顶层cv2模块已直接暴露所有核心API，不再需要通过from cv2 import cv2这种旧方式导入子模块，而旧版本（如4.5.5）的绑定结构支持该写法，因此出现兼容性报错。

解决方法 #

方法1：使用正确的导入语句 #

直接替换旧的导入代码：

import cv2

之后即可正常调用所有OpenCV接口，比如：

print(cv2.__version__)
img = cv2.imread("test.jpg")

方法2：兼容旧代码（添加__init__.py） #

如果要保留from cv2 import cv2这类旧写法，在你的cv2文件夹内创建一个__init__.py文件，写入以下内容：

from .cv2 import *
# 兼容旧导入逻辑
cv2 = __import__('cv2.cv2')

这样旧代码的导入语句就能正常执行，不会再触发绑定错误。

方法3：确保模块路径被Python识别 #

无论用哪种方法，都要保证cv2文件夹所在的父目录在Python的搜索路径中：

• 可以将cv2文件夹复制到Python的site-packages目录下（比如/usr/local/lib/python3.x/site-packages/）
• 或者在运行脚本前设置环境变量：

  export PYTHONPATH=/path/to/your/cv2/folder/parent:$PYTHONPATH
  

  其中/path/to/your/cv2/folder/parent是包含cv2文件夹的上级目录路径。

验证步骤 #

1. 打开Python终端，执行import cv2，打印版本号确认导入成功：

   import cv2
   print(cv2.__version__)  # 应输出4.7.0
   

2. 如果用了方法2，测试旧导入语句：

   from cv2 import cv2
   print(cv2.imread)  # 应正常显示函数对象
   

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