OpenCV导入方式差异及批量报错解决方案咨询

一、三种导入方式的区别 #

• from cv2 import cv2：试图从cv2模块里导出名为cv2的对象/子模块，但你的系统中OpenCV是编译为单个.so文件的独立模块，并非包含子模块的包，不存在名为cv2的导出项，因此触发ImportError。
• import cv2.cv2 as cv2：错误认为cv2是一个包含子模块的包，试图导入其下的cv2子模块，但实际cv2只是单个模块，不是包，所以会提示找不到cv2.cv2模块。
• import cv2 as cv2：这是OpenCV官方推荐的标准导入方式，直接加载顶层的cv2模块，完全匹配你通过apt安装的OpenCV结构，因此能正常运行。

二、无需批量修改脚本的简便解决方案 #

方法1：添加系统级兼容层 #

在Python的系统库目录（即报错里的/usr/lib/python3/dist-packages/）中创建cv2文件夹，在文件夹内新建__init__.py文件，写入以下代码：

import cv2 as _cv2
# 映射真实cv2的所有属性
__all__ = dir(_cv2)
globals().update({k: getattr(_cv2, k) for k in __all__})
# 兼容两种错误导入方式
cv2 = _cv2

这样当脚本执行错误的导入语句时，会优先加载这个自定义的cv2包，自动将真实的cv2模块映射过来，无需修改脚本即可正常运行。

方法2：临时兼容层（不修改系统文件） #

如果不想改动系统目录，可以创建临时兼容结构：

1. 在家目录新建cv2_compat文件夹，再在其中创建cv2子文件夹
2. 在cv2子文件夹中放入上述的__init__.py文件
3. 运行脚本时，将临时兼容目录加入Python搜索路径：

PYTHONPATH=~/cv2_compat:$PYTHONPATH python 你的脚本名.py

方法3：批量修改脚本（彻底解决） #

如果希望一次性修正所有导入语句，可以用sed命令批量替换：

# 替换第一种错误导入语句
find /你的脚本所在目录 -name "*.py" -exec sed -i 's/from cv2 import cv2/import cv2 as cv2/g' {} \;
# 替换第二种错误导入语句
find /你的脚本所在目录 -name "*.py" -exec sed -i 's/import cv2.cv2 as cv2/import cv2 as cv2/g' {} \;

注意：执行前请先备份脚本，避免出现意外。

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