解决ArchLinux下OpenCV-Python和PyQt无法配合使用的问题

问题背景

在学习OpenCV时想使用PyQt作为框架进行开发。由于Python在Linux计算机上运行的非常好，于是就使用了自己一直以来的开发环境Arch Linux。其中Qt框架是在安装KDE桌面的时候已经安装好了的。OpenCV的Python库则是使用的Python自己的pip包管理器进行安装的。

系统环境

Arch_Linux , Qt5 , OpenCV4.4 ， PyCharm 2019.3

问题描述

在某一个项目中仅单独使用cv2或者仅单独使用PyQt5库不会出现任何问题。但是如果混合使用就会出现如下图的报错提示：

Connected to pydev debugger (build 193.6494.30)
QObject::moveToThread: Current thread (0x55d70b575ca0) is not the object's thread (0x55d70b3e92b0).
Cannot move to target thread (0x55d70b575ca0)qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "/home/knomori/.local/lib/python3.8/site-packages/cv2/qt/plugins" even though it was found.
This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.Available platform plugins are: xcb, eglfs, linuxfb, minimal, minimalegl, offscreen, vnc, wayland-egl, wayland, wayland-xcomposite-egl, wayland-xcomposite-glx, webgl.

后来发现在代码中单独使用Qt5或者单独import cv2都没有问题，但如果在已经完成的PyQt代码中import cv2，即使不使用cv2的函数也会出现这个错误。

问题原因

在我的环境中，由于Qt和OpenCV的库是使用不同的包管理器进行安装的，所以库的位置不同。也就是pip和pacman管理的库分别在/usr/lib/qt/plugins和/usr/lib下。（具体的运作方式我也有点谜，但我觉得肯定和Python在寻找库时的先后顺序有关系。。。)

更加详细的讨论可以参考这篇bbs：
链接: [SOLVED] qt.qpa.plugin: Could not find the Qt platform plugin “xcb” in “”

解决方法

仅使用pacman进行两者的安装。

注意在这之前先使用pip卸载opencv-python包！

pip uninstall opencv-python 

接着仅使用pacman安装opencv和所需的依赖：

sudo pacman -S opencv hdf5 python-numpy

其中hdf5和python-numpy是为了让Python能够调用OpenCV库。这样我们的环境就全部由pacman完成了，直接运行你的项目即可。
不建议使用pip进行两者的安装，个人觉得由于Qt的依赖过于繁多，乱卸载的话可能会导致UI的改变或者一些其他不知名的错误。

关于其他的调试方法

网上还有其他的方法比如修改环境变量，在终端输入export QT_DEBUG_PLUGINS=1以查看程序的执行过程，分析具体是哪一个库调用不成功。
在我的机器上只有VSCode可以显示出具体的调试过程，详情可以去搜一下（这类方法网上很多，但是对我的环境不管用）。不过即使加了这句我的PyCharm还是只显示一开始的报错提示。根本无法确定问题的来源。
还有一些方法是使用链接进行寻找库的，详细信息仍就是上面的那个bbs链接。

感想

在最初面对这个问题的时候确实有些手足无措，最开始也是以为qt的安装问题，也搜索了许多关于Qt的东西。不过最终意识到之前的pyqt代码是可以跑的，直到加上了opencv才开始的报错。后来发现只要导入cv2就会报错，于是搜索的方向立刻就转变了。果然这神奇的东西不能只看眼前的信息，想一想pip和pacman的不同也许就会发现问题的根源。
有点遗憾的就是在写这篇文章的时候还不是很清楚这俩具体的调用过程，以后有时间的话会再次进行更新。
希望这篇文章对你有帮助，转载请注明出处，谢谢。