PyQt5安装教程

window 平台安装

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

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

pip3 install PyQt5

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

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

• 安装 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 目录。

• 设置环境变量

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

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

• 验证是否安装成功

执行以下代码：

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!"的窗口，则说明安装成功。

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 打开之后可以直接使用。

Mac 平台安装

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

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

pip3 install pyqt5

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

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

• 安装 Qt Creater

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

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

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

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

如果需要进一步的功能，我推荐大家直接安装一个 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 文件了。

• 验证是否安装成功

执行以下代码：

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!"的窗口，则说明安装成功。