在一次简单的开发过程中,发现我和朋友的多台电脑在使用PyCharm编写用pyQt5实现的一个简单的界面程序时会出现如下错误,
提示语:This application failed to start because no Qt platform plugin could be initialized
同样的代码和电脑,有个别朋友能正常运行,大部分都出现下面这个错误。然后搜索发现,这个问题出现很多年了,光在优快云上就有多篇文章,我也尝试用其中一些方法去解决,效果一般。
我后来思考一下,感觉这个问题可能跟我们使用的开发环境配置有关系,于是记录下来,以便给后面的朋友遇到这个问题,可以作为一个参考
#问题环境陈述
我们这个团队都是使用Win10或者WIN11,用PyCharm作为开发工具,PyCharm的版本有2022,2023和最新的2024,小版本我也没记录
安装的python版本从3.6到3.8,还有3.10以及3.13等
所开发的程序是用pyQt5来实现简单的一个窗口界面
#可能的原因分析
我发现问题出现的原因,可能是python虚拟环境配置的问题,在新建项目时,PyCharm会默认建立一个虚拟环境,我们使用了项目本地的虚拟环境,但是这个虚拟环境的pyQt似乎不能被系统的编译器识别到(即使我们安装的是同一版本的)
经过多次实验,我发现目前针对我们的问题
#最快解决问题的办法是:
将你的项目使用的python解释器 切换到电脑里面python标准版安装路径里面的解释器
在这个项目设置中,找到Python解释器,点击右边那个向下的箭头,然后选择你安装python自带路径那个解释器,如下图,选择下面这个路径的python
Python 3.6 C:/Users/Administrator/AppData/Local/Programs/Python/Python36/python.exe
有的同学可能发现你的这个位置只有一个解释器,这种情况下,你选择右边那个添加解释器按钮
然后选择系统解释器,将路径加进来。
之后就是切换python解释器,运行你的代码了。
#pyQt5的安装方式
这里面还有一个问题没有提及:pyQt5的安装方式
网上提到的方法有很多种,我大概试过3种,目前我们这个错误,应该使用第一种就可以解决,其它方法做了也没有使用到
第一种是直接在命令窗口下面安装,
WIN键+R键,同时按下,然后输入cmd,或者 开始菜单找到运行,打开命令窗口
第二种在PyCharm设置里面安装
如下图,点击这个加号,输入pyqt5
之后选择PyQt5,然后右下角选择安装软件包,这个安装完成后,实际上会安装三个东西,如图中蓝色所示
第三种安装方式是在PyCharm的终端那边安装
这个终端的图标是上图左侧那个带圆形外圈的感叹号图标上方那个,一个正方形的,里面一个大于号和一个下标符合。
输入安装命令 pip install pyQt5
国内安装速度慢的话,可以加入清华镜像
https://pypi.tuna.tsinghua.edu.cn/simple/pip install pyQt5 -i https://pypi.tuna.tsinghua.edu.cn/simple/
最后快写完的时候,发现了一篇文章,感觉我们的做法类似,后续使用UI界面的可以参考
关于pycharm安装pyqt5的一些坑_pycharm安装pyqt5太慢-优快云博客
记录下来,主要是方便自己将来出错的时候,能快速找到解决办法,省的浪费时间。