[ PyQt入门教程 ] PyQt5开发环境搭建和配置

article/2025/9/30 19:54:39

PyQt5工具可以快速实现简单的界面开发，包括界面设计、布局管理以及业务逻辑实现（信号与槽）。简单说就是使用PyQt5工具可以快速画一个控件摆放整齐、界面整洁有序、布局合理的界面。

课程目标
可以动手实现简单的GUI程序。系列文章主要以动手实践案例讲解为主。

课程对象
会一些python基本语法但不懂PyQt的小白

课程内容
第1节：PyQt5环境搭建和配置。工欲善其事必先利其器嘛~~

第2节：Qt Designer工具的使用。通过一个需求实现描述工具使用。都是拖拽布局，不写代码。。不要怂

第3节：Qt Designer工具的布局管理。如何把界面控件摆放整齐。四种常用布局方法。。也不写代码。。哈哈

第4节：PyQt信号与槽的使用。让程序动起来。。让他替你做你想做的事情。。

第5节：PyQt5基本控件使用介绍。了解那些被你拖来拖去的组件的基本使用方法。。深入认识一下他们

第6节：PyQt5小需求实践案例。让你学习的内容转化成可输出的成果。。

本文内容
本文主要第1节 PyQt5环境搭建和配置。主要内容包括：

（1）工具版本的选择，包括PyQt版本和Python软件版本。

（2）Python、PyQt5以及Qt Designer工具的安装。Qt Designer是PyQt的可视化GUI设置工具。

（3）PyCharm上配置Qt Designer和PyUIC工具。

选择PyQt原因
（1）PyQt可以通过拖拽实现界面开发，而不是只能代码实现。这样界面实现效率就高多了。

（2）控件丰富。支持跨平台。

（3）方便打包发布。可以利用Pyinstaller打包成二进制文件。在未安装Python软件电脑上运行。

选择Python3和PyQt5原因
PyQt官网提供了PyQt4和PyQt5两种主流版本。PyQt5不兼容PyQt4。建议选择PyQt5原因：

（1）官方对PyQt4不再有重大更新和维护。

（2）PyQt5对一些模块进行了重新构建。同时PyQt5对网页的支持能力更好。

（3）PyQt5支持新式的信号和槽，使用更简单。

选择Python3原因：PyQt5对Python3支持较好，官方默认只提供支持Python3版本的安装包。如果使用Python2，要自己编译，比较麻烦。

Python3.X软件和PyQt5安装
（1）Python官网下载Python3.X 32位最新版本。获取路径：Python官网，下载32位版本的原因是通常pyqt工具开发完成的程序都需要编译成可执行程序发布。而使用32位额Pyinstaller打包发布exe软件在32位和64位电脑都能运行。如果是64位版本，就只能运行在64位版本电脑。
在这里插入图片描述

（2）执行下载的pyhon软件安装。勾选"Add Python3.7 to Path"。其他一路Next安装完成。默认会安装一键式工具pip。在这里插入图片描述
（3）pip工具镜像源配置。配置方法如下：

    a、在cmd窗口下执行echo %HOMEPATH%获取用户家目录，并在该目录下创建pip目录。b、在pip目录下创建pip.ini文件。记住，后缀必须是.ini格式。并在该文件中写入如下内容。

[global]
index-url = http://pypi.douban.com/simple
[install]
trusted-host = pypi.douban.com
c、配置完成。执行pip install xlrd测试安装是否成功。如果失败，参考配置指导参考<Python开发环境搭建指导>检查，里面有详细步骤。

PyQt5工具安装
（1）使用pip工具安装PyQt5工具。执行pip install PyQt5
在这里插入图片描述
2）安装Qt Designer图形界面开发工具。执行pip install PyQt5-tools

工具安装完成后的路径在…\Python\Python37-32\Lib\site-packages
在这里插入图片描述
（3）环境变量配置。将PyQt5-tools的安装目录添加到系统环境变量path。添加路径：我的电脑 -> 属性->高级->系统设置->高级->单击环境变量。在系统变量path添加PyQt5-tools完整路径。如下图所示：
（4）打开cmd窗口，执行designer。其实也可以将designer.exe设置快捷家到桌面。
在这里插入图片描述
Qt Designer主界面如下：
PyCharm配置Qt Designer
PyCharm是开发Python程序主流常用的IDE。为方便调用Qt Designer实现界面开发和编译相应完成，可以在PyCharm配置Qt Designer和PyUIC。

（1）配置Qt Designer。PyCharm -> 菜单File -> Settings -> Tools -> External Tools -> +号，进行添加。参数配置说明：

Name：Qt Designer。方便记忆。实际可以任意取值。

Program：designer.exe程序绝对路径。根据实际安装路径填写。

Parameters：$FileDir$\$FileName$。固定取值。

Working directory: $FileDir$。固定取值
在这里插入图片描述
（2）配置PyUIC。该工具是用于将Qt Designer工具开发完成的.ui文件转化为.py文件。配置打开路径同Qt Designer。参数配置说明：

Name：PyUIC。方便记忆。实际可以任意取值。

Program：python.exe程序绝对路径。根据实际安装路径填写。

Parameters：-m PyQt5.uic.pyuic $F i l e N am e$ -o $F i l e N am e Wi t h o u tE x t e n s i o n$ .py。固定取值。

Working directory: $F i l eD i r$ 。固定取值。
在这里插入图片描述
（3）测试Qt Designer和PyUIC配置是否成功。打开路径：菜单栏Tools -> External Tools ->Qt Designer/PyUIC

点击Qt Designer，打开Designer程序主界面如下。将左侧Widget Box中Push button空间拖到主界面，双击空间修改名称为test。另存为名称work.ui。默认后缀就是.ui。在这里插入图片描述
打开PyUIC，自动完成work.ui文件的转换。生成文件名为work.ui。

文件转换成功后，可以在project目录中查看。如下
配置成功。完成