PyQt概述

定义：PyQt是Python绑定Qt框架的工具集，用于开发跨平台GUI应用程序
原理：通过Qt的C++库提供底层功能，PyQt使用SIP工具生成Python绑定
特点：

• 支持Windows/macOS/Linux
• 超过620个类
• 同时支持Qt4/Qt5
• MIT/GPL双协议

环境搭建

安装方法：

pip install PyQt5 PyQt5-tools

组件说明：

组件	功能
PyQt5	核心库
PyQt5-tools	设计工具
Qt Designer	可视化设计器
pyuic5	.ui转.py工具

验证安装：

import sys
from PyQt5.QtWidgets import QApplication, QLabel

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

核心组件

1 QWidget

原型：

class QWidget(QObject, QPaintDevice):
    def __init__(self, parent: QWidget = None, flags: Qt.WindowFlags = Qt.WindowFlags())

功能：所有GUI组件的基类
参数：

• parent：父组件
• flags：窗口特性标志

注意事项：

• 顶级窗口parent=None
• 内存管理采用父子对象机制

2 QMainWindow

核心区域：

关键方法：

setCentralWidget(widget)  # 设置中央部件
statusBar().showMessage("Ready")  # 状态栏消息
addToolBar("File")  # 添加工具栏

布局管理

布局类型：

1. QHBoxLayout：水平布局
2. QVBoxLayout：垂直布局
3. QGridLayout：网格布局
4. QFormLayout：表单布局

使用规范：

layout = QVBoxLayout()
layout.addWidget(button1)
layout.addWidget(button2)
container = QWidget()
container.setLayout(layout)

布局嵌套示例：

信号与槽机制

原理：事件驱动编程模型
定义：

• 信号（Signal）：事件发生时发出的通知
• 槽（Slot）：响应信号的函数

连接方式：

button.clicked.connect(self.handle_click)

def handle_click(self):
    print("Button clicked!")

自定义信号：

class Worker(QObject):
    finished = pyqtSignal()
    
    def run(self):
        # 执行任务
        self.finished.emit()

常用控件

控件对比表： 表1：常用控件功能对照

控件	类名	主要功能
按钮	QPushButton	触发操作
标签	QLabel	显示文本/图片
输入框	QLineEdit	单行文本输入
列表框	QListWidget	列表数据展示
表格	QTableWidget	表格数据展示

QTableWidget使用示例：

table = QTableWidget(5, 3)  # 5行3列
table.setHorizontalHeaderLabels(["ID", "Name", "Score"])
table.setItem(0, 0, QTableWidgetItem("001"))
table.setItem(0, 1, QTableWidgetItem("Alice"))

事件处理

事件类型：

• 鼠标事件：QMouseEvent
• 键盘事件：QKeyEvent
• 窗口事件：QResizeEvent

事件处理方式：

def mousePressEvent(self, event):
    if event.button() == Qt.LeftButton:
        print("Left click at", event.pos())

事件过滤器：

app.installEventFilter(self)

def eventFilter(self, obj, event):
    if event.type() == QEvent.KeyPress:
        print("Key pressed:", event.key())
    return super().eventFilter(obj, event)

样式与主题

QSS语法：

QPushButton {
    background-color: #4CAF50;
    border-radius: 5px;
    color: white;
    padding: 8px;
}
QPushButton:hover {
    background-color: #45a049;
}

应用样式：

app.setStyleSheet(open("style.qss").read())

常用样式属性：

属性	说明	示例
background	背景	#FFFFFF
border	边框	1px solid gray
font	字体	bold 14px Arial
qproperty	控件属性	qproperty-alignment: AlignCenter

多线程编程

QThread使用模式：

Worker线程示例：

class Worker(QThread):
    progress = pyqtSignal(int)
    
    def run(self):
        for i in range(101):
            time.sleep(0.1)
            self.progress.emit(i)

注意事项：

• 禁止在工作线程操作GUI
• 使用信号进行线程间通信
• 使用QMutex进行资源锁定

数据库集成

数据库操作流程：

QSqlTableModel示例：

model = QSqlTableModel()
model.setTable("employees")
model.setEditStrategy(QSqlTableModel.OnFieldChange)
model.select()

table = QTableView()
table.setModel(model)

示例：文本编辑器

功能设计：

• 文件操作（新建/打开/保存）
• 文本编辑（复制/粘贴）
• 格式设置（字体/颜色）
• 查找替换

核心代码结构：

class TextEditor(QMainWindow):
    def __init__(self):
        super().__init__()
        # 创建菜单
        file_menu = self.menuBar().addMenu("文件")
        file_menu.addAction("新建", self.new_file)
        
        # 创建工具栏
        toolbar = self.addToolBar("编辑")
        toolbar.addAction("复制", self.text_edit.copy)
        
        # 中央文本编辑区
        self.text_edit = QTextEdit()
        self.setCentralWidget(self.text_edit)
        
        # 状态栏
        self.statusBar().showMessage("就绪")

文件保存实现：

def save_file(self):
    filename, _ = QFileDialog.getSaveFileName(self, "保存文件", "", "文本文件 (*.txt)")
    if filename:
        with open(filename, 'w') as f:
            f.write(self.text_edit.toPlainText())
        self.statusBar().showMessage(f"文件已保存: {filename}")

打包与发布

PyInstaller使用：

pyinstaller --windowed --icon=app.ico main.py

打包参数：

参数	说明
--onefile	单文件打包
--windowed	无控制台窗口
--add-data	添加资源文件
--icon	设置图标

跨平台注意事项：

1. Windows：处理病毒误报
2. macOS：处理签名问题
3. Linux：处理依赖库版本

学习路线图

学习资源：

1. 官方文档：https://www.riverbankcomputing.com/static/Docs/PyQt5/
2. 《PyQt5快速开发与实战》
3. GitHub示例库：PyQt5-Examples

总结

通过本教材的系统学习，我们可以掌握PyQt开发的核心技能，能够独立开发跨平台的桌面应用程序。继续深入实践，您将成为GUI开发领域的专家！

学习提议：

1. 从简单项目开始逐步迭代
2. 善用Qt Designer提高效率
3. 阅读官方示例代码
4. 参与开源项目贡献
5. 定期关注Qt版本更新

#编程# #学习# #python# #在头条记录我的2025#