一、PyQt6 简介与环境搭建
PyQt6 是 Qt 框架的 Python 绑定库,用于开发跨平台 GUI 应用,支持 Windows、macOS、Linux 等系统,功能强大且界面美观。
环境安装(推荐 Python 3.8+):
1. 安装 PyQt6:
pip install PyQt6
2. 安装设计工具 Qt Designer(可选,用于可视化界面设计):
pip install PyQt6-designer
二、第一个 PyQt6 程序:Hello World
以下是一个基础窗口程序,包含窗口创建、标题设置、尺寸调整等核心要素:
import sys
from PyQt6.QtWidgets import QApplication, QMainWindow, QLabel, QPushButton, QVBoxLayout, QWidget
# 创建应用实例
app = QApplication(sys.argv)
# 创建主窗口
window = QMainWindow()
window.setWindowTitle("PyQt6 Hello World")
window.setGeometry(100, 100, 400, 300) # 窗口位置(x,y)和尺寸(width, height)
# 创建中央部件和布局
central_widget = QWidget()
layout = QVBoxLayout(central_widget)
# 添加控件
label = QLabel("你好,PyQt6!", parent=central_widget)
label.setStyleSheet("font-size: 20px;") # 设置字体大小
button = QPushButton("点击我", parent=central_widget)
button.clicked.connect(lambda: label.setText("按钮被点击了!")) # 按钮点击事件
# 将控件添加到布局中
layout.addWidget(label)
layout.addWidget(button)
# 设置中央部件
window.setCentralWidget(central_widget)
# 显示窗口
window.show()
# 进入应用主循环
sys.exit(app.exec())
运行效果:点击按钮后,标签文本会更新。
三、PyQt6 核心概念与实战技巧
1. 界面布局系统
PyQt6 提供多种布局方式,避免手动计算控件位置:
o QVBoxLayout(垂直布局):控件上下排列。
o QHBoxLayout(水平布局):控件左右排列。
o QGridLayout(网格布局):控件按行列排列。
实战案例:计算器界面布局
# 简化版计算器布局示例(完整逻辑需补充计算功能)
layout = QGridLayout()
# 添加数字按钮和运算符按钮到网格中
layout.addWidget(QPushButton("7"), 0, 0)
layout.addWidget(QPushButton("8"), 0, 1)
layout.addWidget(QPushButton("9"), 0, 2)
layout.addWidget(QPushButton("+"), 0, 3)
# ... 更多按钮添加...
2. 信号与槽机制(事件处理)
PyQt6 的核心交互逻辑通过“信号-槽”机制实现,例如按钮点击、文本变化等事件:
o 信号:控件触发的事件(如 button.clicked)。
o 槽函数:响应信号的函数(如 label.setText)。
进阶用法:自定义信号
from PyQt6.QtCore import pyqtSignal, QObject
class MySignal(QObject):
# 定义自定义信号(参数为字符串)
message_sent = pyqtSignal(str)
signal_emitter = MySignal()
signal_emitter.message_sent.connect(lambda msg: print(f"收到消息:{msg}"))
signal_emitter.message_sent.emit("Hello from custom signal!")
3. 窗口与控件类型
o 主窗口类型:
o QMainWindow:带菜单栏、工具栏的应用主窗口。
o QDialog:对话框窗口(模态/非模态)。
o 常用控件:
o QPushButton(按钮)、QLineEdit(单行文本框)、QTextEdit(多行文本框)、QComboBox(下拉框)、QCheckBox(复选框)等。
四、实战项目:简易记事本应用
以下是一个基础记事本程序,包含文本编辑、文件保存/打开等功能:
import sys
from PyQt6.QtWidgets import (QApplication, QMainWindow, QTextEdit, QMenuBar,
QMenu, QAction, QFileDialog, QMessageBox)
from PyQt6.QtGui import QIcon # 如需图标,需先准备icon.png文件
class Notepad(QMainWindow):
def __init__(self):
super().__init__()
self.setWindowTitle("简易记事本")
self.setGeometry(100, 100, 800, 600)
self.filename = ""
# 创建文本编辑区域
self.text_edit = QTextEdit()
self.setCentralWidget(self.text_edit)
# 创建菜单栏
self.create_menu()
def create_menu(self):
# 菜单栏
menu_bar = QMenuBar()
# 文件菜单
file_menu = QMenu("文件", self)
menu_bar.addMenu(file_menu)
# 新建文件
new_action = QAction("新建", self)
new_action.triggered.connect(self.new_file)
file_menu.addAction(new_action)
# 打开文件
open_action = QAction("打开", self)
open_action.triggered.connect(self.open_file)
file_menu.addAction(open_action)
# 保存文件
save_action = QAction("保存", self)
save_action.triggered.connect(self.save_file)
file_menu.addAction(save_action)
# 退出
exit_action = QAction("退出", self)
exit_action.triggered.connect(self.close)
file_menu.addAction(exit_action)
self.setMenuBar(menu_bar)
def new_file(self):
if self.text_edit.document().isModified():
reply = QMessageBox.question(self, "提示", "文件已修改,是否保存?",
QMessageBox.StandardButton.Yes | QMessageBox.StandardButton.No | QMessageBox.StandardButton.Cancel)
if reply == QMessageBox.StandardButton.Yes:
self.save_file()
self.text_edit.clear()
self.filename = ""
def open_file(self):
filename, _ =
QFileDialog.getOpenFileName(self, "打开文件", "", "文本文件 (*.txt);;所有文件 (*)")
if filename:
try:
with open(filename, "r", encoding="utf-8") as f:
self.text_edit.setText(f.read())
self.filename = filename
except Exception as e:
QMessageBox.critical(self, "错误", f"打开文件失败:{str(e)}")
def save_file(self):
if not self.filename:
filename, _ =
QFileDialog.getSaveFileName(self, "保存文件", "", "文本文件 (*.txt);;所有文件 (*)")
if not filename:
return
self.filename = filename
try:
with open(self.filename, "w", encoding="utf-8") as f:
f.write(self.text_edit.toPlainText())
self.text_edit.document().setModified(False)
except Exception as e:
QMessageBox.critical(self, "错误", f"保存文件失败:{str(e)}")
if __name__ == "__main__":
app = QApplication(sys.argv)
notepad = Notepad()
notepad.show()
sys.exit(app.exec())
五、进阶技巧与优化
1. 使用 Qt Designer 可视化设计界面:
o 打开 Designer 工具,拖拽控件生成 .ui 文件,再通过 pyuic6 工具转换为 Python 代码:
pyuic6 -x design.ui -o design.py
o 代码中加载 UI 文件:
from PyQt6 import uic
uic.loadUi("design.ui", self) # self 为窗口实例
2. 样式表(QSS)美化界面:
o 使用类似 CSS 的语法设置控件样式:
button.setStyleSheet("""
background-color: #4CAF50;
color: white;
border-radius: 5px;
padding: 8px;
""")
3. 多线程处理耗时任务:
o 使用 QThread 或 QRunnable 避免界面卡顿(例如网络请求、文件处理)。
六、资源与学习路径
o 官方文档:
o PyQt6 官方文档
o Qt 框架文档
o 实战教程:
o 《PyQt6 快速开发与实战》(书籍)
o YouTube 频道:sentdex、freeCodeCamp(搜索 PyQt6 教程)
o 开源项目参考:
o PyQt6 示例代码
通过以上内容,你可以快速入门 PyQt6 并开发实用的 GUI 应用。从基础窗口到复杂布局,再到实战项目,逐步掌握信号槽机制、界面美化和多线程等核心技能,轻松实现你的 Python GUI 编程需求!
