Python 图形界面框架 PySide6 使用及避坑指南

使用Python开发图形界面的软件其实并不多，相对于GUI界面，可能Web方式的应用更受人欢迎。但基于GUI做一些小工具，还是很实用的。

在界面工具中，PySide6功能强大，与Pycharm相结合，可以满足各种变态与正常的需求。
PySide6的界面目前为两种，一种是传统的QT Widgets，另一种是相对新颖的QML。

本文演示了PySide6 的安装、配置、以天气预报示例演示了开发流程，对期间碰到的问题进行了梳理和总结。
环境信息是：Win10、PyCharm 2020.1、PySide6 6.2.2.1、PyInstaller 4.8、Python 3.7，基于QT Widgets设置图形界面。

安装PySide6

Qt是一个跨平台的C++图形界面应用程序框架。
它提供给开发者建立图形用户界面所需的功能，广泛用于开发GUI程序，也可用于开发非GUI程序。
Qt很容易扩展，并且允许真正地组件编程。
基本上，Qt同X Window上的Motif,Openwin,GTK等图形界面库以及Windows平台上的MFC、OWL、VCL、ATL是同类型的东西。

PySide6是来自于Qt for Python项目的官方Python模块，它提供了对完整Qt 6.0+框架的访问。
Qt Designer 拖拽式的界面设计工具：通过拖拽的方式放置控件，并实时查看控件效果进行快速UI设计
PyUIC：主要是把Qt Designer生成的.ui文件换成.py文件
PyRCC主要是把编写的.qrc资源文件换成.py文件

pip install PySide6

安装的是最新版：6.2.2.1，已经包含了Qt Designer、PyUIC、PyRCC工具

PyCharm中配置External Tools

在 PyCharm中的External Tools中，配置下图的三个工具。
在这里插入图片描述

配置QtDesigner

Name: QtDesigner
Program : D:\program\Anaconda3\Scripts\pyside6-designer.exe # 请根据实际修改
Working directory: $ProjectFileDir$

配置PyUIC

Name: PyUIC
Program : D:\program\Anaconda3\Scripts\pyside6-uic.exe # 请根据实际修改
Arguments：$FileName$ -o $FileNameWithoutExtension$.py
Working directory: $FileDir$

配置PyRCC

Name: PyRCC
Program : D:\program\Anaconda3\Scripts\pyside6-rcc.exe # 请根据实际修改
Arguments：$FileName$ -o $FileNameWithoutExtension$_rc.py
Working directory: $FileDir$

使用示例

使用PySide6开发一个天气预报查询页面，通过选择广东不同的地市，查询不同地市的天气预报信息。

代码结构如下：
在这里插入图片描述

使用QtDesigner进行界面设计

整个画面的构成：

左侧的“Widget Box”就是各种可以自由拖动的组件
中间的“MainWindow – weather.ui”窗体就是画布
右上方的”Object Inspector”可以查看当前ui的结构
右侧中部的”Property Editor”可以设置当前选中组件的属性
右下方的”Resource Browser”可以添加各种素材，比如图片，背景等等

最终生成.ui文件（实质上是XML格式的文件），可直接使用，也可以通过PyUIC工具转换成.py文件。

本示例用到的控件有Button, GroupBox, Label,ComboBox,TextEdit，同时定义了两个按钮searchBtn及clearBtn，分别用来查询及清空天气数据：

针对按钮设置信号/槽，也可以不设置，生成python代码后在代码中添加。

在Qt Designer右下角选择信号/槽编辑器，点击+号新增
分别选择searchBtn及clearBtn，选择信号 clicked(), 接收者 QtWeather 及槽【内置了一些常用的槽函数，如close,repaint,hide】，（槽函数这里不知道如何定义，后期在代码里再进行修改）

设置完成后，保存为weather.ui文件。
在这里插入图片描述

转换.ui文件为.py文件

为了更好的自定义及修改上面的槽函数，可以选择weather.ui，然后右键打开External Tools – PyUIC，即可生成weather.py，实际运行命令如下：

D:\program\Anaconda3\Scripts\pyside6-uic.exe weather.ui -o weather.py

绑定槽函数

设置两个按钮绑定的槽函数

self.seachBtn.clicked.connect(QtWeather.queryWeather)
self.clearBtn.clicked.connect(QtWeather.clearText)

设置下拉列表内容

详见weather.py代码
将selectBox下拉列表选择设置为广东的21个地市，并且默认选择第三个。

# -*- coding: utf-8 -*-################################################################################## Form generated from reading UI file 'weather.ui'## Created by: Qt User Interface Compiler version 6.2.2## WARNING! All changes made in this file will be lost when recompiling UI file!################################################################################from PySide6.QtCore import(QCoreApplication, QMetaObject, QRect,
                            Qt)from PySide6.QtWidgets import(QComboBox, QGroupBox, QLabel,
                               QMenuBar, QPushButton, QStatusBar, QTextEdit, QWidget)classUi_QtWeather(object):defsetupUi(self, QtWeather):ifnot QtWeather.objectName():
            QtWeather.setObjectName(u"QtWeather")
        QtWeather.setWindowModality(Qt.ApplicationModal)
        QtWeather.resize(360,398)
        self.centralwidget = QWidget(QtWeather)
        self.centralwidget.setObjectName(u"centralwidget")
        self.groupBox = QGroupBox(self.centralwidget)
        self.groupBox.setObjectName(u"groupBox")
        self.groupBox.setGeometry(QRect(20,20,321,301))
        self.cityLabel = QLabel(self.groupBox)
        self.cityLabel.setObjectName(u"cityLabel")
        self.cityLabel.setGeometry(QRect(20,30,31,16))
        self.selectBox = QComboBox(self.groupBox)
        self.selectBox.setObjectName(u"selectBox")
        self.selectBox.setGeometry(QRect(60,30,231,22))
        self.selectBox.setEditable(True)
        self.textEdit = QTextEdit(self.groupBox)
        self.textEdit.setObjectName(u"textEdit")
        self.textEdit.setGeometry(QRect(20,70,271,211))
        self.clearBtn = QPushButton(self.centralwidget)
        self.clearBtn.setObjectName(u"clearBtn")
        self.clearBtn.setGeometry(QRect(30,330,75,24))
        self.seachBtn = QPushButton(self.centralwidget)
        self.seachBtn.setObjectName(u"seachBtn")
        self.seachBtn.setGeometry(QRect(270,330,75,24))
        QtWeather.setCentralWidget(self.centralwidget)
        self.menubar = QMenuBar(QtWeather)
        self.menubar.setObjectName(u"menubar")
        self.menubar.setGeometry(QRect(0,0,360,22))
        QtWeather.setMenuBar(self.menubar)
        self.statusbar = QStatusBar(QtWeather)
        self.statusbar.setObjectName(u"statusbar")
        QtWeather.setStatusBar(self.statusbar)

        self.retranslateUi(QtWeather)

        self.seachBtn.clicked.connect(QtWeather.queryWeather)
        self.clearBtn.clicked.connect(QtWeather.clearText)

        QMetaObject.connectSlotsByName(QtWeather)# setupUidefretranslateUi(self, QtWeather):
        _translate = QCoreApplication.translate
        QtWeather.setWindowTitle(_translate("QtWeather",u"MainWindow",None))
        self.groupBox.setTitle(_translate("QtWeather",u"城市天气预报",None))
        self.cityLabel.setText(_translate("QtWeather",u"城市",None))
        self.clearBtn.setText(_translate("QtWeather",u"清空",None))
        self.seachBtn.setText(_translate("QtWeather",u"查询",None))

        self.selectBox.addItem("广州")
        self.selectBox.addItem("韶关")
        self.selectBox.addItem("深圳")
        self.selectBox.addItem("珠海")
        self.selectBox.addItem("汕头")
        self.selectBox.addItem("佛山")
        self.selectBox.addItem("江门")
        self.selectBox.addItem("湛江")
        self.selectBox.addItem("茂名")
        self.selectBox.addItem("肇庆")
        self.selectBox.addItem("惠州")
        self.selectBox.addItem("梅州")
        self.selectBox.addItem("汕尾")
        self.selectBox.addItem("河源")
        self.selectBox.addItem("阳江")
        self.selectBox.addItem("清远")
        self.selectBox.addItem("东莞")
        self.selectBox.addItem("中山")
        self.selectBox.addItem("潮州")
        self.selectBox.addItem("揭阳")
        self.selectBox.addItem("云浮")#设置默认值
        self.selectBox.setCurrentIndex(3)
        self.selectBox.currentText()# retranslateUi

编写应用业务逻辑

在MainWindow中调用界面类Ui_QtWeather，然后在其中添加查询天气的业务逻辑代码，这样就做到了界面显示和业务逻辑的分离。

新增myapp.py文件，在MainWindow类中定义两个槽函数queryWeather()和clearText()，以便在界面文件weather.ui中定义的两个按钮(searchBtn 和clearBtn) 触发clicked 信号与这两个槽函数进行绑定。

Application组件讲解：

QApplication()：每个GUI都必须包含一个QApplication，argv表示获取命令行参数。
QMainWindow()：类似一个容器(窗口) - QMainWindow类提供一个带有菜单条，工具条和一个状态条的主应用程序窗口。主窗口通常提供一个大的中央窗口部件，以及周围菜单，工具条，和一个状态栏。- 用来包含按钮、文本、输入框等widgets。arg标识可以获取命令行执行时的参数。
setGeometry是用来定义 MainWindow() 窗口的尺寸，语法：setGeometry(x, y, width, height )，其中x,y为屏幕上的坐标点。
show()：用来显示窗口
exit(app.exec())：设置窗口一直运行，直到使用关闭按钮进行关闭
QWidget类是所有用户界面对象的基类，窗口部件是用户界面的一个基本单元，它从窗口系统接收鼠标，键盘和其他消息，并在屏幕上绘制自己。一个窗口部件可以被他的父窗口或者是其他窗口挡住一部分。
QDialog类是对话框窗口的基类，对话框窗口主要用于短期任务和用户进行短期通讯的顶级窗口，QDialog可以是模态对话框或者是非模态对话框。QDialog支持扩展并带有返回值，他们可以带有默认值

import sys
import requests
from PySide6.QtWidgets import QApplication, QMainWindow
from weather import Ui_QtWeather

classMainWindow(QMainWindow):def__init__(self):super().__init__()
        self.ui = Ui_QtWeather()
        self.ui.setupUi(self)
        self.cityDict ={"广州":"440100","韶关":"440200","深圳":"440300","珠海":"440400","汕头":"440500","佛山":"440600","江门":"440700","湛江":"440800","茂名":"440900","肇庆":"441200","惠州":"441300","梅州":"441400","汕尾":"441500","河源":"441600","阳江":"441700","清远":"441800","东莞":"441900","中山":"442000","潮州":"445100","揭阳":"445200","云浮":"445300"}defqueryWeather(self):
        cityName = self.ui.selectBox.currentText()
        cityCode = self.getCode(cityName)

        r = requests.get("https://restapi.amap.com/v3/weather/weatherInfo?key=f4fd5b287b6d7d51a3c60fee24e42002&city={}".format(cityCode))if r.status_code ==200:
            data = r.json()['lives'][0]
            weatherMsg ='城市：{}\n天气：{}\n温度：{}\n风向：{}\n风力：{}\n湿度：{}\n发布时间：{}\n'.format(
                data['city'],
                data['weather'],
                data['temperature'],
                data['winddirection'],
                data['windpower'],
                data['humidity'],
                data['reporttime'],)else:
            weatherMsg ='天气查询失败，请稍后再试！'
        self.ui.textEdit.setText(weatherMsg)defgetCode(self, cityName):return self.cityDict.get(cityName,'广州')defclearText(self):
        self.ui.textEdit.clear()if __name__ =='__main__':
    app = QApplication(sys.argv)

    window = MainWindow()
    window.setGeometry(150,150,360,398)
    window.setWindowTitle("QT 简单示例教程")
    window.show()

    sys.exit(app.exec())

运行效果

在这里插入图片描述

将代码打包成exe文件

将.py文件打包成可执行的exe在Python中称为freezing，常用的工具有：PyInstaller, py2exe, fbs等。

py2exe：软件更新已经不活跃，因此也就略过。
pyinstaller：明确支持win8、win10、理论上支持win7,，支持apple Macos, linux。pyinsaller可以打包成文件夹形式内含exe入口执行文件的形式，也可以是一个单独的exe文件。
fbs：基于PyInstaller，使用起来更加方便，但开源版本只支持python 3.6/3.7

本文使用pyinstaller打包
打包后会在项目目录下生成dist / myapp 目录，在此目录中包含一个myapp.exe文件，点击可运行。

#安装,版本是4.8
pip install pyinstaller

#打包
pyinstaller E:\pycodes\qt-test\myapp.py

附录

错误解决

PyCharm中运行报Qt platform plugin could be initialized

运行myapp.py时，报错：This application failed to start because not Qt platform plugin could be initialized.Reinstalling the application may fix this problem.
解决方案有如下2种：

设置环境变量: QT_QPA_PLATFORM_PLUGIN_PATH = D:\program\Anaconda3\Lib\site-packages\PySide6\plugins\platforms
在程序初始部分添加如下代码:

dirname = os.path.dirname(PySide6.__file__)
plugin_path = os.path.join(dirname,'plugins','platforms')print(plugin_path)
os.environ['QT_QPA_PLATFORM_PLUGIN_PATH']= plugin_path

PySide6程序打包后无法运行 no Qt platform plugin could be initialized

使用Pyinstaller打包之后的可执行文件无法运行，显示的报错信息：This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.
在这里插入图片描述

方案1: 经过与PySide 2打包后的文件进行对比，发现Pyinstaller打包的文件目录里缺少了Qt运行所需的一些文件，如下：- plugins- translations- qt.conf在哪里找到PySide 6需要的这些文件呢? 步骤如下：- 使用下面的命令查询PySide 6的安装位置（Location）pip show PySide6- 进入到安装目录，再进入子目录（PySide6）- 找到并复制 plugins、translations、qt.conf 打包目录的PySide6下即可。
方案2 将打包命令修改为：pyinstaller myapp.py --noconsole --hidden-import PySide6.QtXml参数说明- -w, --windowed, --noconsole Windows and Mac OS X: do not provide a console window for standard i/o. On Mac OS this also triggers building a Mac OS .app bundle. On Windows this option is automatically set if the first script is a ‘.pyw’ file. This option is ignored on *NIX systems.- --hidden-import MODULENAME, --hiddenimport MODULENAME Name an import not visible in the code of the script(s). This option can be used multiple times.- PySide6.QtXml 包含模块类的定义

标签： python PySide6 PyInstaller

本文转载自: https://blog.csdn.net/penriver/article/details/122686212
版权归原作者 java编程艺术 所有，如有侵权，请联系我们删除。

Python 图形界面框架 PySide6 使用及避坑指南

安装PySide6

安装PySide6

PyCharm中配置External Tools

配置QtDesigner

配置PyUIC

配置PyRCC

使用示例

使用QtDesigner进行界面设计

转换.ui文件为.py文件

绑定槽函数

设置下拉列表内容

编写应用业务逻辑

运行效果

将代码打包成exe文件

附录

错误解决

PyCharm中运行报Qt platform plugin could be initialized

PySide6程序打包后无法运行 no Qt platform plugin could be initialized

发表评论

“Python 图形界面框架 PySide6 使用及避坑指南”的评论:

关于作者

overfit同步小助手

相关阅读

文章导航