
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、 学习路径建议
- 先跑通示例:把上面的窗口和计数器程序亲手敲一遍,理解事件循环;
- 掌握布局与常用控件:按钮、输入框、列表、表格、对话框;
- 理解信号与槽:这是 PyQt 的核心思想,务必吃透;
- 学习 Qt Designer:提升界面搭建效率;
- 进阶主题 :多线程(
QThread)、模型视图(QTableView+QAbstractTableModel)、自定义绘制(QPainter)、打包发布(PyInstaller)。
9、 小结
PyQt 把成熟的 Qt 框架带进了 Python 生态,既有跨平台、控件丰富、信号槽解耦等工程优势,又保留了 Python 简洁易读的开发体验。对于需要快速构建桌面应用的 Python 开发者来说,它是一个值得投入时间学习的选择。后续文章将围绕布局管理、信号与槽、常用控件和打包发布等主题逐步展开。
