PyQt简介

PyQt简介

    • [1、什么是 PyQt](#1、什么是 PyQt)
    • [2、 PyQt 的核心特点](#2、 PyQt 的核心特点)
      • [2.1 跨平台](#2.1 跨平台)
      • [2.2 控件丰富](#2.2 控件丰富)
      • [2.3 信号与槽机制](#2.3 信号与槽机制)
      • [2.4 布局管理](#2.4 布局管理)
      • [2.5 支持 Qt Designer](#2.5 支持 Qt Designer)
    • [3、PyQt 的版本演进](#3、PyQt 的版本演进)
    • [4、PyQt 与 PySide 的区别](#4、PyQt 与 PySide 的区别)
    • 5、典型应用场景
    • 6、环境准备与安装
    • 7、一个完整的入门示例
    • [8、 学习路径建议](#8、 学习路径建议)
    • [9、 小结](#9、 小结)

1、什么是 PyQt

PyQt 是 Python 语言对 Qt 应用框架的绑定库,由英国 Riverbank Computing 公司开发维护。它把 Qt 强大的跨平台 GUI 能力封装成 Python 模块,让开发者可以用 Python 写出在 Windows、macOS、Linux 上原生运行的桌面应用。

简单来说:

  • Qt 是 C++ 编写的成熟跨平台应用框架,被大量商业软件使用;
  • PyQt 是 Qt 的 Python 封装,让你用 Python 的语法调用 Qt 的能力;
  • 你写一份代码,编译/打包后即可在多个操作系统上运行。
python 复制代码
import sys
from PyQt5.QtWidgets import QApplication, QLabel

app = QApplication(sys.argv)
label = QLabel("Hello, PyQt!")
label.show()
sys.exit(app.exec_())

上面这段不到十行的代码,就能弹出一个带文字的窗口,这正是 PyQt 上手门槛低的体现。

2、 PyQt 的核心特点

2.1 跨平台

同一份代码可以在 Windows、macOS、Linux 上运行,界面风格会自动适配当前系统,也可以手动指定统一的主题风格。

2.2 控件丰富

Qt 提供了按钮、表格、树形控件、文本编辑器、绘图区、浏览器内核等大量现成控件,绝大多数桌面应用需要的界面元素都能直接找到。

2.3 信号与槽机制

这是 Qt 最具特色的设计。控件之间通过「信号(signal)」和「槽(slot)」通信,而不是直接互相调用,从而大幅降低模块耦合。

python 复制代码
from PyQt5.QtWidgets import QApplication, QPushButton

app = QApplication([])
button = QPushButton("点我")

def on_clicked():
    print("按钮被点击了")

button.clicked.connect(on_clicked)  # 信号连接到槽函数
button.show()
app.exec_()

2.4 布局管理

PyQt 提供 QVBoxLayout、QHBoxLayout、QGridLayout 等布局管理器,界面会随窗口缩放自动调整,无需手动计算坐标。

2.5 支持 Qt Designer

可以通过可视化拖拽工具 Qt Designer 设计界面,保存为 .ui 文件后再用 pyuic 转换成 Python 代码,实现「所见即所得」的开发方式。

3、PyQt 的版本演进

版本 对应 Qt 版本 主要特点
PyQt4 Qt 4 早期版本,已停止维护
PyQt5 Qt 5 使用最广泛,生态成熟,教程资料丰富
PyQt6 Qt 6 当前主推版本,支持高 DPI、新特性,API 有部分调整

选择建议:

  • 新项目优先考虑 PyQt6,享受 Qt 6 的长期支持;
  • 若依赖的第三方库或教程仍基于 Qt 5,使用 PyQt5 更稳妥;
  • 老项目迁移时注意 PyQt6 中部分枚举改为全限定名(如 Qt.AlignLeft → Qt.AlignmentFlag.AlignLeft)。

4、PyQt 与 PySide 的区别

两者都是 Qt 的 Python 绑定,功能高度相似,主要差异在授权协议:

  • PyQt:GPL 商业双授权,闭源商用需购买商业许可;
  • PySide:由 Qt 官方(The Qt Company)维护,采用 LGPL 协议,闭源商用更友好。

如果项目需要闭源分发且不想购买授权,PySide6 通常是更省心的选择;如果只是学习或个人开源项目,两者几乎没有差别。

5、典型应用场景

  • 桌面工具软件:配置管理、数据转换、批量处理小工具;
  • 科学计算可视化:结合 Matplotlib、NumPy 做交互式图表界面;
  • 工业与嵌入式上位机:串口通信、设备监控面板;
  • 内部管理系统:替代部分轻量级 Web 后台的桌面客户端;
  • 教学演示程序:快速搭建带界面的算法演示。

6、环境准备与安装

PyQt 通过 pip 即可安装,建议使用虚拟环境隔离依赖。

bash 复制代码
# 创建并激活虚拟环境
python -m venv venv
# Windows
venv\Scripts\activate
# macOS / Linux
source venv/bin/activate

# 安装 PyQt5
pip install PyQt5

# 或安装 PyQt6
pip install PyQt6

安装完成后可以运行下面的代码验证环境是否正常:

python 复制代码
import sys
from PyQt5.QtWidgets import QApplication, QWidget

app = QApplication(sys.argv)
window = QWidget()
window.setWindowTitle("PyQt 环境验证")
window.resize(400, 300)
window.show()
sys.exit(app.exec_())

如果能看到一个标题为「PyQt 环境验证」的空白窗口,说明环境配置成功。

7、一个完整的入门示例

下面用面向对象的方式写一个带按钮和标签的小程序,演示信号与槽的实际用法:

python 复制代码
import sys
from PyQt5.QtWidgets import (
    QApplication, QWidget, QVBoxLayout, QPushButton, QLabel
)

class CounterWindow(QWidget):
    def __init__(self):
        super().__init__()
        self.count = 0
        self.setWindowTitle("计数器示例")
        self.resize(300, 200)

        self.label = QLabel("当前计数:0", self)
        self.button = QPushButton("点我 +1", self)
        self.button.clicked.connect(self.increase)

        layout = QVBoxLayout()
        layout.addWidget(self.label)
        layout.addWidget(self.button)
        self.setLayout(layout)

    def increase(self):
        self.count += 1
        self.label.setText(f"当前计数:{self.count}")

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = CounterWindow()
    window.show()
    sys.exit(app.exec_())

这段代码涵盖了 PyQt 开发的几个基本要素:应用对象 QApplication、窗口控件 QWidget、布局管理器、信号与槽连接,以及事件循环 exec_()。

8、 学习路径建议

  1. 先跑通示例:把上面的窗口和计数器程序亲手敲一遍,理解事件循环;
  2. 掌握布局与常用控件:按钮、输入框、列表、表格、对话框;
  3. 理解信号与槽:这是 PyQt 的核心思想,务必吃透;
  4. 学习 Qt Designer:提升界面搭建效率;
  5. 进阶主题 :多线程(QThread)、模型视图(QTableView + QAbstractTableModel)、自定义绘制(QPainter)、打包发布(PyInstaller)。

9、 小结

PyQt 把成熟的 Qt 框架带进了 Python 生态,既有跨平台、控件丰富、信号槽解耦等工程优势,又保留了 Python 简洁易读的开发体验。对于需要快速构建桌面应用的 Python 开发者来说,它是一个值得投入时间学习的选择。后续文章将围绕布局管理、信号与槽、常用控件和打包发布等主题逐步展开。

相关推荐
wuyk55515 天前
PyQt6-第15讲-数据可视化QChart
python·ui·信息可视化·pyqt
wuyk55524 天前
PyQt6-第10讲-PDF工具箱
python·microsoft·pdf·pyqt
wuyk55524 天前
PyQt6-第14讲-数据库与Excel双向同步
数据库·python·ui·excel·pyqt
MrWind灬25 天前
我给自己写了个 Kafka 桌面客户端:MrWindKafkaClient
kafka·pyqt
万粉变现经纪人1 个月前
如何解决 pip install 安装报错 检测到 yanked 版本需更换可用版本 问题
人工智能·python·scrapy·numpy·pandas·pyqt·pip
MoRanzhi12031 个月前
第6篇(下)· 使用 PyQt5 实现 2048 高性能计算版:统一运行控制与跨模式安全交接
python·pyqt·进程管理·状态机·软件架构·并发控制·数据一致性
wuyk5551 个月前
PyQt6-第06讲-主窗口框架
python·pyqt
MoRanzhi12031 个月前
第6篇(中)· 使用 PyQt5 实现 2048 高性能计算版:无头后台求解与三档运行模式
python·pyqt·数据持久化·多进程·进程间通讯·后台任务·断点续跑
wuyk5551 个月前
PyQt6-第05讲-QtDesigner工作流与ui文件
python·ui·pyqt