PyQt5安装以及使用

1 简介

开发工具为PyCharm，Anaconda。配置过程可能遇到问题：1）没有designer.exe，单独安装Qt Designer即可；2）没有pyuic5.exe，用命令行将ui文件转为py文件即可。

2 安装方法

安装方法有三种：
1）源码编译，复杂就不介绍了
2）直接命令：pip install PyQt5
3）通过命令：pip install PyQt5‑5.15.9‑cp37‑cp37m‑win_amd64.whl

2.1 方法1 pip install PyQt5

由于国内网络原因可能出现链接超时错误：

Collecting PyQt5
  Downloading PyQt5-5.15.9-cp37-abi3-win_amd64.whl (6.8 MB)
     ━━╸━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 0.4/6.8 MB 36.5 kB/s eta 0:02:56
ERROR: Exception:
Traceback (most recent call last):
  File "D:\Users\anaconda3\envs\lib\site-packages\pip\_vendor\urllib3\response.py", line 438, in _error_catcher
    yield
1
2
3
4
5
6
7

解决方法，更换国内镜像：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
1

然后再执行

pip install PyQt5
1

2.2 方法2 pip install PyQt5‑5.15.9‑cp37‑cp37m‑win_amd64.whl

使用一个下载完整安装包并手动安装的方式。从 PyQt5官方网站 下载预编译的安装包，并通过本地安装来安装 PyQt5。在下载后，可以使用以下命令进行本地安装：

pip install PyQt5‑5.15.9‑cp37‑cp37m‑win_amd64.whl
1

3 安装PyQt5-tools

PyQt5-tools 是 PyQt5 的附加工具包，它包含了一些用于 PyQt5 开发的辅助工具。其中最常用的工具是 Qt Designer，它用于创建和编辑 PyQt5 用户界面的可视化设计。首先确保已经安装了 PyQt5。以下是如何安装和使用 PyQt5-tools 的步骤：

pip install PyQt5-tools
1

运行 Qt Designer：安装完成后，可以在命令提示符或 PowerShell 中运行 designer 命令来启动 Qt Designer。或者可以在开始菜单中找到 Qt Designer 图标并启动它。

designer
1

4 设置环境变量

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

5 测试

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())
1
2
3
4
5
6
7
8
9

6 Qt Designer

6.1 安装

如果上述步骤操作之后，找不到designer.exe，此时我们需要下载对应系统版本的Qt Designer软件，然后安装即可。我是直接安装了qt-opensource-windows-x86-msvc2013-5.6.0.exe，如果你不做C++开发的话，仅需要安装Qt Designer即可。安装路径随意。

在 https://build-system.fman.io/qt-designer-download 这个网址可以下载和安装独立的 Qt Designer 安装版，根据操作系统选择合适的安装文件进行安装。

Qt Designer 安装后，在安装目录下面有一个 designer.exe 文件。打开该程序，以拖拽的方式设计界面元素。设计完成后保存为 xxx.ui 文件。ui 文件为 xml 格式，用于描述窗体和控件的属性。

6.2 在 PyCharm 中配置 Qt Designer

在 PyCharm 中配置 Qt Designer，目的是在开发的时候，在 PyCharm 中直接操作 Qt Designer，同时能方便的将 ui 文件保存到 Python 工程指定的文件夹下。通过菜单 File -> Settings 打开如下的配置界面，点击右键 “+” 号配置 Qt Designer:

左边是配置的路径，右面是配置的参数：
Program： designer.exe 的路径
Working Directory: 设置保存的 UI 文件位置，$FileDir$ 表示文件所在目录。

这个配置适合调用 Qt Designer 新建窗口的情况。如果要对已经创建的 ui 文件进行编辑，为了方便，可以再新建一个配置如下：

6.3 在PyCharm中测试Qt Designer

测试一下。比如在 Python 工程中新建一个 designer 文件夹，选中 designer 文件夹
通过菜单 Tools -> External Tools 菜单打开 qt designer:

注意这里的 QT Designer Create 和 QT Designer Edit 都是我刚才配置的外部工具。在 Qt Designer 中新建一个 Main Window:
然后将界面保存为 MainWindow.ui，路径为 designer 文件夹下面。选中 MainWindow.ui，通过菜单 Tools -> External Tools -> QT Desinger Edit，MainWindow.ui 文件被 Qt Designer 打开。Qt Designer 的配置没有问题。

7 将ui文件转为py文件

7.1 方法1 使用pyuic5命令

在终端中输入命令将ui文件转为py。

pyuic5 designer/untitled.ui -o output_ui.py
1

也可以配置成外部工具：

Arguments 参数，我们需要一个宏来实现文件名的灵活性，所以 Arguments 设置如下：

$FileName$ -o $FileNameWithoutExtension$.py
1

完成这个配置后，选中 MainWindow.ui，通过菜单 Tools -> External Tools -> P有UIC5，自动将 ui 文件转换为 python 代码。

7.2 方法2 使用pyside2-uic

如果你使用的是PyQt5，你也可以尝试使用pyside2-uic工具来将UI文件转换为Python代码。首先确保你的虚拟环境中已经安装了PySide2：

pip install PySide2
1

ui转py文件命令：

pyside2-uic.exe designer/mainwindow.ui -o mainwindow.py  
1

如8.1节所示，可以设置一个外部工具：

完成这个配置后，选中 MainWindow.ui，通过菜单 Tools -> External Tools -> PySide2，自动将 ui 文件转换为 python 代码。

7.3 测试

ui 转换的 python 代码随着对 ui 的变更，每次都会重新生成，所以不要在 MainWIndow.py 中编写代码。我们需要另外新建一个 python 文件，并在其中编写代码来调用界面代码。

在转出来的py文件中也有完整的测试代码，下面是自己写的一个测试代码：

# 导入生成的 Python 代码
from PyQt5 import QtCore, QtGui, QtWidgets
from output_ui import Ui_MainWindow

class MyWindow(QtWidgets.QMainWindow):
    def __init__(self):
        super(MyWindow, self).__init__()
        self.ui = Ui_MainWindow()
        self.ui.setupUi(self)
        self.show()

if __name__ == '__main__':
    app = QtWidgets.QApplication([])
    window = MyWindow()
    app.exec_()


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

参考：
[1] PyQt5安装以及使用教程合集(2022)
[2] PyCharm如何使用Qt Designer
[3] PyQT5: 构建图形用户界面的Python指南
[4] 在pyqt中使用matplotlib