代码收藏家技术教程 2024-12-23

Python-PyQt5入门保姆级教程–从安装到使用

前言：近几天看了CSDN上各个Python博主对有关PyQt5安装到使用的保姆级教程，感觉还是不够清晰明了，举个例子：各个博主们在讲解如何给PyCharm配置QtDesigner,PyUIC和Pyrcc等外部工具时，大部分只会告诉你把参数"Program"设为python的安装目录下的python.exe文件，亦或是把参数"Arguments"设为python的安装目录下的Scripts下的pyrcc5.exe文件。可是，对于部分Python学习者来讲，Ta是不太懂这些的：python的安装目录下的python.exe文件在哪里？python的安装目录下的Scripts下的pyrcc5.exe文件又在哪里？因此我认为有必要对此进行更近一步的讲解，帮助需要的同学渡过PyQt5安装到使用这一过程。

第一步：安装PyQt5

(我的安装环境为虚拟环境) 那怎么判断自己PyCharm的当前运行环境是不是为虚拟环境呢？这里有一个简单的判别方法：检查项目目录，如果你的项目目录下有一个名为venv的目录，这通常意味着你正在使用虚拟环境。（如下红色椭圆圈注所示）

如果自己PyCharm当前的运行环境不是为虚拟环境怎么办呢？没关系，我们手动激活虚拟环境就行了：我们打开PyCharm终端，输入"conda activate venv",回车等待即可（当然，也可以自行创建虚拟环境并激活。这里就不在扩展了，感兴趣的可以找相关教程）。（如下所示）

确保自己的运行环境为虚拟环境后，我们正式开始安装PyQt5:打开PyCharm终端，输入"pip install PyQt5"。

pip install PyQt5

然后回车等待一段时间。当看到运行结果为"…Successfully installed PyQt5"时，就代表我们下载好PyQt5了。这里由于我已经下载好了PyQt5了，因此输入"pip install PyQt5"回车后的结果为“Requirement already satisfied”。（如下所示）

（拓展：检查PyQt5是否已下载好的两种方法）

一：终端输入"pip show PyQt5",回车查看是否报错。（如果出现红色报错提示，表明PyQt5未下载成功；如果未出现红色报错提示，系统将给出PyQt5的有关信息）。（如下黄色椭圆圈注所示：下载成功）

二：终端输入"pip list",查看列表中是否有PyQt5。（如果可以在下方列表中找到"PyQt5"，表明PyQt5下载成功，否则表明PyQt5未下载成功）。（如下蓝色椭圆圈注所示：下载成功）

第二步：安装pyqt5-tools

安装方法与第一步相同:终端输入"pip install pyqt5-tools",回车等待。（检查方法与上同）

pip install pyqt5-tools

遇到下载不了的情况，在安装指令后空一格添加下面的指令。

-i https://pypi.tuna.tsinghua.edu.cn/simple

（如下所示）

第三步：给PyCharm配置外部工具

添加步骤：（按照下方图片进行操作）

点击加号即可对QtDesigner,PyUIC,Pyrcc进行逐一配置（可参照图中所示配置）。

1，配置Qt Designer

名称：QtDesigner

工作目录：$FileDir$

名称：QtDesigner

工作目录：$FileDir$

（如下图片中椭圆圈注所示）

程序：（按照下方图片所示找到python的安装目录下的python.exe文件的路径并复制）

（将路径复制后粘贴到"程序"参数里就可以了）

其它地方不用管

2，配置PyUIC

名称:PyUIC

实参:-m PyQt5.uic.pyuic $FileName$ -o $FileNameWithoutExtension$.py

工作目录:$FileDir$

名称:PyUIC
实参:-m PyQt5.uic.pyuic  $FileName$ -o $FileNameWithoutExtension$.py
工作目录:$FileDir$

程序:(按照下方图片所示找到python的安装目录下的python.exe文件的路径并复制)

（将路径复制后粘贴到"程序"参数里就可以了）

其它地方不用管

3，配置Pyrcc

名称:Pyrcc

实参:$FileName$ -o $FileNameWithoutExtension$_rc.py

工作目录:$FileDir$

名称:Pyrcc

实参:$FileName$ -o $FileNameWithoutExtension$_rc.py

工作目录:$FileDir$

程序:(按照下方图片所示找到python的安装目录下的Scripts下的pyrcc5.exe文件的路径并复制)

（我的是将实参设为python的安装目录下的python.exe文件的路径了，不必感到奇怪）

（将路径复制后粘贴到"程序"参数里就可以了）

其它地方不用管。

OK啦，配置完成。来看看效果！

我们点击PyCharm左上方“工具”->"外部工具"。如果能看到QtDesigner,PyUIC,Pyrcc，就表明我们的配置成功了。（如下所示）

我们尝试点击一下QtDesigner，进入一个全新界面并弹出了一个窗口。接着我们点击左边"Vertical Layout"，在窗口中圈定范围，接着拖动左边"PushButton"到范围内，发现PushButton自动垂直布局（如下所示）

我们接着点击"文件"->”保存“。（如下所示）

然后我们会发现项目下面多了一个ui文件（默认为untitled.ui）（绿色图标，扩展名为ui）。我们尝试点击打开看一下。（如下所示）

接着我们右键点击ui文件，点击"PyUIC"。（如下所示）

接着我们就会发现项目下面又多了一个python文件(默认为untitled.py)，它其实就是untitled.ui文件转化来的。我们尝试点击打开（如下所示）

我们接着写一个驱动程序文件setup.py来运行untitled.py文件。（如下所示）

import sys
import untitled

from PyQt5.QtWidgets import QApplication,QMainWindow

if __name__ == '__main__':
    # 只有直接运行这个脚本，才会往下执行
    # 别的脚本文件执行，不会调用这个条件句

    # 实例化，传参
    app = QApplication(sys.argv)

    # 创建对象
    mainWindow = QMainWindow()

    # 创建ui，引用demo1文件中的Ui_MainWindow类
    ui = untitled.Ui_MainWindow()
    # 调用Ui_MainWindow类的setupUi，创建初始组件
    ui.setupUi(mainWindow)
    # 创建窗口
    mainWindow.show()
    # 进入程序的主循环，并通过exit函数确保主循环安全结束(该释放资源的一定要释放)
    sys.exit(app.exec_())

运行一下setup.py文件，出现了我们在QtDesigner新界面窗口设计的GUI样式（如下所示）