PyQt5 安装指南【附安装包】

测机电子枸吴咬风

已于 2024-07-08 17:37:06 修改

阅读量1k

点赞数 17

分类专栏：办公高效工具文章标签： qt python 开发语言

于 2024-07-06 14:40:23 首次发布

本文链接：https://blog.csdn.net/weixin_44081256/article/details/140228404

版权

办公高效工具专栏收录该内容

11 篇文章 16 订阅

订阅专栏

文章目录

1、PyQt简介
2、安装步骤
- 2.1 方法1 pip install PyQt5
- 2.2 方法2 pip install PyQt5‑5.15.9‑cp37‑cp37m‑win_amd64.whl
3 安装PyQt5-tools
4 设置环境变量
5 测试
6 Qt Designer
7 将ui文件转为py文件
- 7.2 方法2 使用pyside2-uic
- 7.3 测试
总结

提示：以下是本篇文章正文内容，下面案例可供参考

1、PyQt简介

开发工具为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

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

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

然后再执行

pip install PyQt5

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

3 安装PyQt5-tools

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

pip install PyQt5-tools

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

designer

常见的报错为安装PyQt5-tools时报错如下

Installing collected packages: PyQt5
Successfully installed PyQt5-5.15.10
(PyQt-py39) PS C:\Users\liushurui> pip install PyQt5-tools
Collecting PyQt5-tools
  Using cached pyqt5_tools-5.15.9.3.3-py3-none-any.whl.metadata (8.3 kB)
Collecting click (from PyQt5-tools)
  Using cached click-8.1.7-py3-none-any.whl.metadata (3.0 kB)
Collecting pyqt5==5.15.9 (from PyQt5-tools)
  Using cached PyQt5-5.15.9-cp37-abi3-win_amd64.whl.metadata (2.2 kB)
INFO: pip is looking at multiple versions of pyqt5-tools to determine which version is compatible with other requirements. This could take a while.
Collecting PyQt5-tools
  Using cached pyqt5_tools-5.15.4.3.2-py3-none-any.whl.metadata (8.3 kB)
Collecting pyqt5==5.15.4 (from PyQt5-tools)
  Using cached PyQt5-5.15.4.tar.gz (3.3 MB)
  Installing build dependencies ... done
  Getting requirements to build wheel ... done
  Preparing metadata (pyproject.toml) ... error
  error: subprocess-exited-with-error

  × Preparing metadata (pyproject.toml) did not run successfully.
  │ exit code: 1
  ╰─> [26 lines of output]
      pyproject.toml: line 7: using '[tool.sip.metadata]' to specify the project metadata is deprecated and will be removed in SIP v7.0.0, use '[project]' instead
      Traceback (most recent call last):
        File "C:\Users\liushurui\.conda\envs\PyQt-py39\Lib\site-packages\pip\_vendor\pyproject_hooks\_in_process\_in_process.py", line 353, in <module>
          main()
        File "C:\Users\liushurui\.conda\envs\PyQt-py39\Lib\site-packages\pip\_vendor\pyproject_hooks\_in_process\_in_process.py", line 335, in main
          json_out['return_val'] = hook(**hook_input['kwargs'])
                                   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        File "C:\Users\liushurui\.conda\envs\PyQt-py39\Lib\site-packages\pip\_vendor\pyproject_hooks\_in_process\_in_process.py", line 152, in prepare_metadata_for_build_wheel
          whl_basename = backend.build_wheel(metadata_directory, config_settings)
                         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        File "C:\Users\liushurui\AppData\Local\Temp\pip-build-env-txffwgjw\overlay\Lib\site-packages\sipbuild\api.py", line 46, in build_wheel
          project = AbstractProject.bootstrap('wheel',
                    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        File "C:\Users\liushurui\AppData\Local\Temp\pip-build-env-txffwgjw\overlay\Lib\site-packages\sipbuild\abstract_project.py", line 92, in bootstrap
          project.setup(pyproject, tool, tool_description)
        File "C:\Users\liushurui\AppData\Local\Temp\pip-build-env-txffwgjw\overlay\Lib\site-packages\sipbuild\project.py", line 587, in setup
          self.apply_user_defaults(tool)
        File "C:\Users\liushurui\AppData\Local\Temp\pip-install-uzs7kduo\pyqt5_86a7a88f5c1f4913b4bc5d058164b41d\project.py", line 63, in apply_user_defaults
          super().apply_user_defaults(tool)
        File "C:\Users\liushurui\AppData\Local\Temp\pip-build-env-txffwgjw\overlay\Lib\site-packages\pyqtbuild\project.py", line 70, in apply_user_defaults
          super().apply_user_defaults(tool)
        File "C:\Users\liushurui\AppData\Local\Temp\pip-build-env-txffwgjw\overlay\Lib\site-packages\sipbuild\project.py", line 237, in apply_user_defaults
          self.builder.apply_user_defaults(tool)
        File "C:\Users\liushurui\AppData\Local\Temp\pip-build-env-txffwgjw\overlay\Lib\site-packages\pyqtbuild\builder.py", line 69, in apply_user_defaults
          raise PyProjectOptionException('qmake',
      sipbuild.pyproject.PyProjectOptionException
      [end of output]

  note: This error originates from a subprocess, and is likely not a problem with pip.
error: metadata-generation-failed

× Encountered error while generating package metadata.
╰─> See above for output.

这是因为PyQt5-tools对python版本仅支持到3.9，可以通过以下命令查看python当前版本

python --version

更改python版本方法为

conda install python=3.8

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())

在这里插入图片描述

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 文件位置，F i l e D i r FileDirFileDir 表示文件所在目录。

这个配置适合调用 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文件

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

pyuic5 designer/untitled.ui -o output_ui.py

在这里插入图片描述

也可以配置成外部工具：
在这里插入图片描述
Arguments 参数，我们需要一个宏来实现文件名的灵活性，所以 Arguments 设置如下：

$FileName$ -o $FileNameWithoutExtension$.py

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

7.2 方法2 使用pyside2-uic

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

pip install PySide2

ui转py文件命令：

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

如7.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_()

在这里插入图片描述

总结

至此PyQt就安装完成了

测机电子枸吴咬风

关注

17
点赞
踩
26

收藏

觉得还不错? 一键收藏
打赏
0
评论
PyQt5 安装指南【附安装包】

PyQt5 是 Digia的一套 Qt5 应用框架与 python 的结合，同时支持 python2.x和 python3.x。本文主要介绍了在 Window 平台下如何安装PyQt5，以及如何在 PyCharm 下开发核心要点。。
复制链接

扫一扫