声明:本人使用的Pycharm为2024.1.1版本,Windows系统。
一、配置:
首先打开Pycharm后新建一个项目,如果你的电脑里已经有了Python,Python版本将会被自动检测并选中,如果你还未安装Python可以点击官网链接去下载(https://www.python.org/),不过需要提醒的是Python版本高于3.9的在后续是无法配置pyqt5的,原因是pyqt5-tools的版本没有跟上Python版本,注意:请牢记自己电脑中Python的安装路径,可能会用到。
1.下载软件包
在文件中找到"设置"选项 ,在设置里(项目:自己的命名),如下图中选择"Python解释器",点击加号后在弹窗中直接搜索pyqt5,这里需要找到并下载两个软件包:pyqt5和pyqt5-tools。
下载这两个软件包时如果下载速度过慢,可以在pycharm软件库中导入国内镜像源,如下图。
在较低版本的pycharm中,新软件库可以在"Python解释器"中添加,如上图在点击加号后的弹窗中还有一个加号,点击弹窗中的的加号就可以添加软件库了。
几个国内镜像源:
阿里云 https://mirrors.aliyun.com/pypi/simple/
中国科技大学 https://pypi.mirrors.ustc.edu.cn/simple/
豆瓣(douban) https://pypi.douban.com/simple/
清华大学 https://pypi.tuna.tsinghua.edu.cn/simple/
中国科学技术大学 https://pypi.mirrors.ustc.edu.cn/simple/
下载完 pyqt5和pyqt5-tools后在设置中找到"工具"里的"外部工具",如下图,点击加号。
2.qtdesigner
先配置qtdesigner,如下图,名称建议为qtdesigner,见名知意,组和描述自己决定,关键是程序和工作目录的设置,推荐直接点击右侧的文件夹图案,这样会直接跳到你这个项目目录中,比如我的就是直接进入E:\软件\PyCharm2024.1.1\PycharmProjects\PYQT5_TEST,然后在这个目录中找到\.venv\Lib\site-packages\qt5_applications\Qt\bin\designer.exe,工作目录可以自己随便选择,不过要保证pycharm能找到它,并可与当前项目连接。
以下是我的程序和工作目录 ,可参考:
程序:E:\软件\PyCharm2024.1.1\PycharmProjects\PYQT5_TEST\.venv\Lib\site-packages\qt5_applications\Qt\bin\designer.exe
工作目录:E:\软件\PyCharm2024.1.1\PycharmProjects\PYQT5_TEST
3.pyuic
接下来配置pyuic,如下图,名称建议为pyuic,见名知意,组要和qtdesigner在同一组,设置程序和工作目录时依旧推荐直接点击右侧的文件夹图案,然后在这个目录中找到\.venv\Scripts\pyuic5.exe,pyuic的工作目录要保证和qtdesigner的一致,最关键的是实参的设置,这里我直接给你:$FileName$ -o $FileNameWithoutExtension$.py -x
你也可以自己在加号里去找,不过它只会提供$之间的参数给你,依旧需要自己完善。
以下是我的程序和工作目录 ,可参考:
程序:E:\软件\PyCharm2024.1.1\PycharmProjects\PYQT5_TEST\.venv\Scripts\pyuic5.exe
实参:$FileName$ -o $FileNameWithoutExtension$.py -x
工作目录:E:\软件\PyCharm2024.1.1\PycharmProjects\PYQT5_TEST
二、验证:
以上就完成了pyqt5的配置,接下来我们验证一下是否配置成功。
完成以上两个工具的配置后会发现在"工具"栏中出现了你自己命名的组,我的是test_tool,点击qtdesigner。
点击后如果出现以下界面则表示qtdesigner配置成功 。
可以尝试先随便编辑一个窗口样式并保存,如下图是我设计的 。
返回Pycharm后会发现项目目录中出现了一个.ui文件,右键这个ui文件使用pyuic将其转换为.py文件,运行新生成的.py文件可以发现电脑生成了一个windows窗口,且窗口样式和自己设计的一致。
三、报错:
当然,大多数情况下以上步骤是无法真正配置成功的,一般在我们尝试运行生成的.py文件时会有如下警告:
这是因为你的电脑系统缺少一个环境变量,这需要我们手动添加。
步骤如下:
1.返回电脑桌面,鼠标右键“我的电脑”,选择“属性”;
2.点击“属性”后会进入设置中的“系统>系统信息”,在该界面找到“高级系统设置”;
3.点击“高级系统设置”后会打开一个名为“系统属性”的窗口,在该窗口中的“高级”分页里有一个“环境变量”选项,点击它;
4.进入“环境变量”窗口后会显示“XXX的用户变量”和“系统变量”两个变量框,请注意:我们需要在系统变量中去添加缺少的变量,如果你将变量误添加在用户变量中可能会导致你的电脑中部分软件无法正常使用!点击“系统变量”下的“新建”按钮。
5.输入变量名,变量名唯一:
变量名:QT_QPA_PLATFORM_PLUGIN_PATH
比较麻烦的是变量值的设置,因为这需要你找到你的Python的安装位置,然后在Python中找到\Lib\site-packages\PyQt5\Qt5\plugins\platforms。
下面是我的路径,可参考:
E:\软件\PyCharm2024.1.1\Python3.9\Lib\site-packages\PyQt5\Qt5\plugins\platforms
完成以上步骤后关闭并重启 pycharm软件,重新运行.py文件发现不在报错,成功生成窗口。