ArchLinux系统Python虚拟环境中OpenCV运行段错误问题咨询

Python调用OpenCV本质是加载对应Python版本编译的C++扩展模块（.so动态库文件），该扩展模块需要同时链接OpenCV核心库、系统GUI渲染依赖、图像处理相关依赖（如hdf5、vtk等），所有依赖的版本、编译参数完全匹配才能正常运行，出现依赖版本不匹配时就会触发内存访问错误，也就是你遇到的segmentation fault。

你遇到的差异核心原因如下：

• 系统中通过pacman安装的python-opencv是Arch官方针对当前滚动发行版的Python版本、系统Qt/GTK图形栈、预装的opencv、hdf5、vtk依赖统一编译的绑定，不属于pip管理的包，因此你在系统Python中执行pip list看不到opencv-python，但可以正常import调用，兼容性极高。
• 虚拟环境默认会隔离系统的site-packages目录，无法访问系统预编译的python-opencv绑定。你通过pip安装的opencv-python是官方预编译的通用二进制包，自带了一套裁剪过的OpenCV依赖，不会复用你系统中安装的opencv相关库，和Arch滚动更新的系统依赖版本不匹配，调用GUI相关接口（如cv2.imshow）时就会触发段错误。

可根据你的使用场景选择以下任意一种方案解决：

• 复用系统原生绑定（推荐，兼容性最好）
  创建虚拟环境时添加--system-site-packages参数，允许虚拟环境调用系统级的Python包，不需要额外在虚拟环境中安装opencv-python：

  python -m venv --system-site-packages 你的虚拟环境名称
  

  如果是已经创建好的虚拟环境，可以修改虚拟环境目录下的pyvenv.cfg文件，将include-system-site-packages参数改为true即可。
• 虚拟环境内源码编译适配
  如果你需要在虚拟环境中使用独立的OpenCV版本，不要使用预编译的二进制包，执行以下命令强制从源码编译opencv-python，编译过程会自动适配你系统的所有依赖：

  # 先安装编译依赖
  sudo pacman -S base-devel cmake
  # 源码安装opencv-python
  pip install --no-binary opencv-python opencv-python numpy
  

• 软链接系统绑定（应急方案）
  先卸载虚拟环境中安装的pip版OpenCV：

  pip uninstall -y opencv-python opencv-python-headless
  

  查找系统中python-opencv的绑定文件路径：

  find /usr/lib/python* -name "cv2*.so"
  

  将查找到的.so文件软链接到虚拟环境的site-packages目录即可，示例：

  ln -s /usr/lib/python3.11/site-packages/cv2.cpython-311-x86_64-linux-gnu.so /path/to/your/venv/lib/python3.11/site-packages/
  

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