PyQt5安装以及使用教程合集(2024)

小小的梦呓

「小小的梦呓」(就职某全球500强｜技术&职场分享)

本文主要介绍了在 Window 和Mac 平台下如何安装PyQt5，以及如何在 PyCharm 下开发核心要点。

（Linux 部分可以参考Mac 平台的安装）

1. 简介

PyQt5 是 Digia的一套 Qt5 应用框架与 python 的结合，同时支持 python2.x和 python3.x。

这里使用的是Python 3.x。Qt库由 Riverbank Computing开发，是最强大的GUI库之一。

PyQt5 是由一系列 Python 模块组成。超过 620 个类，6000 函数和方法。能在诸如 Unix、Windows 和Mac OS 等主流操作系统上运行。PyQt5 有两种证书，GPL和商业证书。

PyQt5 的官网链接如下：

http://www.riverbankcomputing.co.uk/news。

当然也可以在 Python 这里查看教程。

https://pythonspot.com/pyqt5/

2. window 平台安装

2.1 安装 PyQt5

PyQt5 有两种安装方式，一种是从官网下载源码安装，另外一种是使用 pip 安装。

这里我推荐大家使用pip 安装。因为它会自动根据你的Python 版本来选择合适的 PyQt5 版本，如果是手动下载源码安装，难免会选择出错。建议使用比较稳妥的安装方式。

pip3 install PyQt5

另外，如果你的网络访问外网不是很好的话建议使用豆瓣的镜像下载，不然会很很慢或者直接安装失败。

pip install PyQt5 -i https://pypi.douban.com/simple

2.2 安装 PyQt5-tools

PyQt5 不再提供常用Qt工具，比如图形界面开发工具Qt Designer、国际化翻译工具Liguist 如果开发中使用到这些，必须自行安装Qt工具。

这里我们还是采用脚本安装的方式。

pip install PyQt5-tools

或者使用镜像下载：

pip install PyQt5-tools -i https://pypi.douban.com/simple

这里有个需要注意的地方，PyQt5 版本的不同，安装成功之后，PyQt5 相关文件夹以及目录也会存在一些差异。

PyQt 5.15.x 之前的版本：

安装完成后在 %Python_path%\Lib\site-packages目录中可以看到PyQt5、pyqt5-tools、PyQt5-sip 目录

PyQt 5.15.x 以及之后的版本：

安装完成后在 %Python_path%\Lib\site-packages 目录中可以看到 PyQt5、pyqt5-tools、PyQt5-sip 、以及多了的 qt_applications qt5-tools 目录。

2.3 设置环境变量

在桌面上右键单击“我的电脑”，在弹出的快捷菜单中选择“属性”->“高级系统设置”->“高级”，单击环境变量按钮，在系统变量Path中添加pyqt5-tools目录的绝对路径。

在 Windows 命令行输入 echo %Path% 命令。如果一切正常，则会在返回的 Path 路径中看到刚才配置的路径。

2.4 验证是否安装成功

执行以下代码：

import sys
from PyQt5.QtWidgets import QWidget, QApplication

app = QApplication(sys.argv)
widget = QWidget()
widget.resize(640, 480)
widget.setWindowTitle("Hello, PyQt5!")
widget.show()
sys.exit(app.exec())

如果没有报错，弹出了一个标题为"Hello, PyQt5!"的窗口，则说明安装成功。

2.5 QT Designer

另外，window 平台， PyQt-tools 默认安装 QT Designer.exe。

PyQt 5.15.x 之前的版本：

路径在%Python_path%\Lib\site-packages|pyqt5_tools\Qt\bin\desginer.exe

PyQt 5.15.x 以及之后的版本：

路径在 %Python_path%\Lib\site-packages\qt5_applications\Qt\bin\designer.exe

双击 designer.exe 打开之后可以直接使用。

3. Mac 平台安装

3.1 安装 PyQt5

Mac 平台下的安装和 Window 安装差不多。也是支持手动下载源码安装和一键脚本安装。

这里我使用的是一键脚本安装。命令和 Window 一样。

pip3 install pyqt5

网速较慢的情况下，也可以使用镜像

pip install PyQt5 -i https://pypi.douban.com/simple

3.2 安装 Qt Creater

Mac 平台下不需要而外安装 Qt-tools. 因为默认已经安装。可以在 /usr/local/Cellar/qt/5.12.1/libexec/找到。

进入这个文件夹的方法： “访达”->"前往"->"前往文件夹"->"输入路径"->"回车"即可。

比如我们可以看到 Desginer.exe.

当然这个 Desginer.exe 很清凉。使用起来也很方便。

如果需要进一步的功能，我推荐大家直接安装一个 QT Desginer. 下载链接：

https://download.qt.io/official_releases/qtcreator/4.12/4.12.4/qt-creator-opensource-mac-x86_64-4.12.4.dmg

下载安装之后，选择 “新建文件或项目” 之后，安装下图选择，就可以新建出 ui 文件了。

一直 Next之后，可以看到如下界面。

3.3 验证是否安装成功

执行以下代码：

import sys
from PyQt5.QtWidgets import QWidget, QApplication

app = QApplication(sys.argv)
widget = QWidget()
widget.resize(640, 480)
widget.setWindowTitle("Hello, PyQt5!")
widget.show()
sys.exit(app.exec())

如果没有报错，弹出了一个标题为"Hello, PyQt5!"的窗口，则说明安装成功。