当前位置：首页 > news >正文

【PyQt5】PyQt5初探 - 一个简单的例程

news 来源：原创 2025/6/3 19:50:18

PyQt5初探 - 一个简单的例程

引言
一、安装配置
二、使用
- 2.1 PyQt5简单例程
- 2.2 与c++ Qt深入对比
三、相关教程

引言

PyQt5是一个比较流行的Python图形用户界面(GUI)库，它基于Qt库（一个跨平台的C++库，用于开发应用程序的图形界面）为Python开发者提供了一个强大的工具，用于创建专业的GUI应用程序，而无需深入了解底层的C++编程。

其与Qt (c++)相比，主要的优缺点如下：
– PyQt5优点：较高的开发效率和易用性，语法相对简单，python有意思的第三方库很多，可直接拿来用
– PyQt5缺点：较低的运行效率，特别是进行打包封装成可执行文件，体积很难缩小，进一步降低了运行效率
感觉也是python相比c++的优缺点…

一、安装配置

网上教程很多，可参考如下博文：

python pyqt5+vtk安装以及配置采坑记录：https://blog.csdn.net/qq_38204686/article/details/123445607
PyQt5实现多文件调用以及UI和逻辑分离：https://zhuanlan.zhihu.com/p/95082345

二、使用

在这里插入图片描述

程序运行如上图所示，源码如下所示：

2.1 PyQt5简单例程

1. 本例程代码结构如下所示，其中main.py存放主函数，也是程序入口；main.py会调用MainWindow.py，里面存放主窗体相关函数；MainWindow.py会调用ui_MainWindow.py，里面是主窗体的界面设计；而ui_MainWindow.py是由designer.exe设计的MainWindow.ui使用pyuic5.exe生成的。(类似QtCreator的界面和逻辑分离)
1. main.py，创建一个主窗体并显示

from PyQt5.QtGui import *
from PyQt5.QtWidgets import *
from MainWindow import MainWindow
import sysif __name__ == '__main__':app = QApplication(sys.argv)mainWindow = MainWindow()mainWindow.show()sys.exit(app.exec_())

1. MainWindow.py，界面初始化，设置主窗体标题为"Title"

from PyQt5.QtWidgets import *
from PyQt5.QtCore import *
from ui_MainWindow import Ui_MainWindow
import osclass MainWindow(QMainWindow):ui = Nonedef __init__(self, parent=None):super(MainWindow, self).__init__(parent)# 0. 界面初始化self.ui = Ui_MainWindow()self.ui.setupUi(self)self.setWindowTitle("Title")

1. ui_MainWindow.py，由MainWindow.ui生成的py文件，供其他py调用，其在Qt designer中的显示和内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<ui version="4.0"><class>MainWindow</class><widget class="QMainWindow" name="MainWindow"><property name="geometry"><rect><x>0</x><y>0</y><width>799</width><height>620</height></rect></property><property name="windowTitle"><string>MainWindow</string></property><widget class="QWidget" name="centralwidget"><layout class="QGridLayout" name="gridLayout_2"><item row="0" column="0"><widget class="QLabel" name="label"><property name="text"><string>我是个标题</string></property><property name="alignment"><set>Qt::AlignCenter</set></property></widget></item></layout></widget><widget class="QMenuBar" name="menubar"><property name="geometry"><rect><x>0</x><y>0</y><width>799</width><height>26</height></rect></property></widget><widget class="QStatusBar" name="statusbar"/></widget><resources/><connections/>
</ui>

2.2 与c++ Qt深入对比

本文python使用的PyQt仿照了c++ Qt的结构，但还是略有不同：

1. 文件结构
  
  两者类似，都有main作为程序入口，只不过python没有.h和.cpp之分，c++还多了pro文件配置编译参数。两者的.ui文件一致，python的需要转为.py文件被调用，而c++的会自动生成ui_mainwindow.h被.cpp文件调用，如下图所示 (Qt creator会自动生成，VS好像还需要配置)，保持之前使用c++ Qt的习惯，我将python下.ui文件转成的.py文件之前也增加了ui_。
1. ui_mainwindow.h与ui_MainWindow.py
  
  setupUI函数一致，都要传递一个QMainWindow，然后对其进行修改。c++ Qt调用时候默认是给.h添加一个界面私有变量，然后.cpp调用其setupUI函数，传入类本身 (this指针)进行界面绘制。python也是类似的用法，看到有一篇博客没有new 一个Ui_MainWindow，而是直接继承Ui_MainWindow，都能调用其setupUI函数。
  
  了解其UI文件生成以及调用的逻辑，自己直接在.py文件里写代码亦可。相比c++会灵活一些，毕竟没有私有变量。

三、相关教程

The complete PyQt5 tutorial — Create GUI applications with Python: https://www.pythonguis.com/pyqt5-tutorial/
PyQt5文档: https://www.riverbankcomputing.com/static/Docs/PyQt5/index.html#