PyQt6 入门到实战:用 Python 打造精美 GUI 应用

一、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 编程需求!

#我的宝藏兴趣##py thon##py thon##为什么要努力学习,为什么要读书#

原文链接:,转发请注明来源!