PyQt5 入门指南：从安装到第一个桌面应用

发布时间：2026/9/24 12:08:58

PyQt5 入门指南：从安装到第一个桌面应用
文章目录引言环境准备与安装第一个 PyQt5 窗口常用控件介绍信号与槽机制布局管理实战简易计算器总结摘要本文面向 Python 初学者从环境安装到实战开发系统讲解 PyQt5 的核心控件、信号槽机制与布局管理并通过简易计算器示例帮助读者快速上手桌面应用开发。1. 引言PyQt5 是 Python 语言下最流行的 GUI 开发框架之一基于 Qt 5 构建能够帮助开发者快速创建跨平台的桌面应用程序。无论是简单的工具软件还是功能复杂的商业应用PyQt5 都提供了丰富的控件和强大的信号槽机制让界面开发变得高效而灵活。本文将从环境安装开始带你逐步掌握 PyQt5 的核心概念并通过一个完整的实战示例帮助你快速上手第一个桌面应用。2. 环境准备与安装在开始之前请确保你的电脑已经安装了 Python 3.6 及以上版本。推荐使用虚拟环境来隔离项目依赖避免不同项目之间的包冲突。安装 PyQt5 非常简单使用 pip 即可完成pip install PyQt5如果需要使用 Qt Designer 进行可视化界面设计可以额外安装 Qt 工具pip install pyqt5-tools安装完成后可以在 Python 交互环境中验证是否安装成功import PyQt5 print(PyQt5.__version__)3. 第一个 PyQt5 窗口下面我们创建一个最简单的窗口程序它会在屏幕上显示一个空白窗口。这是学习 PyQt5 的第一步也是理解事件循环机制的基础。import sys from PyQt5.QtWidgets import QApplication, QWidget app QApplication(sys.argv) window QWidget() window.setWindowTitle(我的第一个 PyQt5 窗口) window.resize(400, 300) window.show() sys.exit(app.exec_())这段代码的核心逻辑如下QApplication每个 PyQt5 程序都必须创建一个 QApplication 实例它负责管理整个应用的事件循环。QWidget是所有用户界面对象的基类这里直接创建了一个空白窗口。app.exec_()进入事件循环程序会一直运行直到窗口被关闭。4. 常用控件介绍PyQt5 提供了丰富的控件库下面介绍几个最常用的控件及其基本用法。4.1 按钮 QPushButton按钮是交互界面中最常见的控件通过点击可以触发相应的事件from PyQt5.QtWidgets import QPushButton button QPushButton(点击我, window) button.move(50, 50) button.clicked.connect(on_click)4.2 标签 QLabel标签用于显示文本或图片是最基础的展示控件from PyQt5.QtWidgets import QLabel label QLabel(Hello, PyQt5!, window) label.move(50, 100)4.3 输入框 QLineEdit输入框用于接收用户输入的单行文本from PyQt5.QtWidgets import QLineEdit edit QLineEdit(window) edit.move(50, 150) edit.setPlaceholderText(请输入内容)5. 信号与槽机制信号与槽是 PyQt5 的核心机制用于处理控件之间的交互。当用户操作控件时如点击按钮、输入文本控件会发出信号连接的槽函数会被自动调用。下面是一个完整的示例演示按钮点击后更新标签文本import sys from PyQt5.QtWidgets import QApplication, QWidget, QPushButton, QLabel class MyWindow(QWidget): def __init__(self): super().__init__() self.init_ui() def init_ui(self): self.setWindowTitle(信号与槽示例) self.setGeometry(100, 100, 300, 200) self.label QLabel(还没有点击按钮, self) self.label.move(50, 50) button QPushButton(点击我, self) button.move(50, 100) button.clicked.connect(self.on_button_click) def on_button_click(self): self.label.setText(按钮已被点击) if __name__ __main__: app QApplication(sys.argv) window MyWindow() window.show() sys.exit(app.exec_())在这个例子中clicked是按钮的信号on_button_click是槽函数。当按钮被点击时信号触发槽函数执行标签文本随之更新。6. 布局管理手动指定控件位置虽然简单但窗口大小变化时控件不会自动调整。PyQt5 提供了多种布局管理器让界面能够自适应窗口尺寸。6.1 垂直布局 QVBoxLayoutfrom PyQt5.QtWidgets import QVBoxLayout layout QVBoxLayout() layout.addWidget(button1) layout.addWidget(button2) window.setLayout(layout)6.2 水平布局 QHBoxLayoutfrom PyQt5.QtWidgets import QHBoxLayout layout QHBoxLayout() layout.addWidget(label) layout.addWidget(edit) window.setLayout(layout)6.3 网格布局 QGridLayout网格布局适合表单类界面可以按行列排列控件from PyQt5.QtWidgets import QGridLayout layout QGridLayout() layout.addWidget(label_name, 0, 0) layout.addWidget(edit_name, 0, 1) layout.addWidget(label_age, 1, 0) layout.addWidget(edit_age, 1, 1) window.setLayout(layout)7. 实战简易计算器综合以上知识我们来实现一个简易计算器支持加、减、乘、除四种运算。这个示例涵盖了控件创建、布局管理和信号槽机制的综合运用。import sys from PyQt5.QtWidgets import (QApplication, QWidget, QLineEdit, QPushButton, QGridLayout) class Calculator(QWidget): def __init__(self): super().__init__() self.init_ui() def init_ui(self): self.setWindowTitle(简易计算器) self.result QLineEdit() self.result.setReadOnly(True) grid QGridLayout() grid.addWidget(self.result, 0, 0, 1, 4) buttons [ 7, 8, 9, /, 4, 5, 6, *, 1, 2, 3, -, 0, ., , ] positions [(i 1, j) for i in range(4) for j in range(4)] for position, text in zip(positions, buttons): button QPushButton(text) button.clicked.connect(self.on_click) grid.addWidget(button, *position) self.setLayout(grid) def on_click(self): 处理按钮点击事件支持四则运算并包含完善的错误处理。 sender self.sender() text sender.text() # 点击等号时尝试计算结果 if text : expression self.result.text() # 检查表达式是否为空 if not expression: self.result.setText(错误) return # 检查表达式是否以运算符结尾连续运算符或末尾运算符 if expression[-1] in -*/: self.result.setText(错误) return try: # 使用 eval 计算表达式结果 result eval(expression) self.result.setText(str(result)) except ZeroDivisionError: # 除零错误处理 self.result.setText(除数不能为零) except SyntaxError: # 表达式语法错误如连续运算符、无效表达式 self.result.setText(表达式无效) except Exception: # 其他未知错误 self.result.setText(错误) else: # 点击数字或运算符时追加到当前表达式 current self.result.text() # 防止连续输入运算符如 12 if text in -*/ and current and current[-1] in -*/: # 用新运算符替换末尾的旧运算符 self.result.setText(current[:-1] text) else: self.result.setText(current text) if __name__ __main__: app QApplication(sys.argv) calc Calculator() calc.show() sys.exit(app.exec_())运行这段代码你会得到一个可以正常进行四则运算的简易计算器。改进后的on_click方法增加了除零错误、无效表达式和连续运算符等情况的处理并添加了相应的注释说明。你可以在此基础上继续扩展比如增加括号支持、历史记录等功能。8. 总结本文从环境安装开始介绍了 PyQt5 的核心概念和常用控件并通过信号槽机制和布局管理最终实现了一个简易计算器。PyQt5 的功能远不止于此它还支持多线程、数据库、网络通信、绘图等高级特性。建议下一步深入学习以下方向使用 Qt Designer 可视化设计界面提高开发效率。掌握 QThread 多线程编程避免界面卡顿。学习 QSS 样式表美化应用界面。结合数据库和网络模块开发功能完整的桌面应用。希望本文能帮助你顺利开启 PyQt5 的学习之旅祝你开发愉快

相关新闻

fidder避坑指南

fidder避坑指南

3个步骤搞定Fiddler环境，源码解析助你避坑 配置环境就卡半天，这大概是每个后端或测试工程师在接入 Fiddler 时的共同噩梦。你下载了安装包，双击运行，结果浏览器毫无反应，或者抓包全是乱码，甚至直接导致服务崩溃。别急，今天我不讲虚的…

2026/9/24 12:08:24 阅读更多 →
前端实现table表格高亮demo，vue+elementui

前端实现table表格高亮demo，vue+elementui

<template><div><el-table ref"myTable" :data"tableData" style"width:100%"><el-table-column prop"data" lable"日期" width"180"><template slot-scope"scope"><…

2026/9/23 9:48:25 阅读更多 →
unity urp的内置后期效果参数

unity urp的内置后期效果参数

效果参数详解1. Tonemapping 色调映射参数含义展厅 Mode映射算法&#xff1a;None&#xff08;不映射&#xff0c;易死白&#xff09;/ Neutral&#xff08;中性&#xff09;/ ACES&#xff08;电影感&#xff0c;对比更稳&#xff09;ACES2. Bloom 泛光参数含义推荐Threshold多…

2026/9/23 9:48:25 阅读更多 →

最新新闻

轻触开关选型与验证：汽车电子与端侧AI硬件的可靠之选

轻触开关选型与验证：汽车电子与端侧AI硬件的可靠之选

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/9/24 12:08:06 阅读更多 →
PHPStan `notIdentical.alwaysTrue` 错误详解：`!==` 恒为 true 的类型分析逻辑与修复方案

PHPStan `notIdentical.alwaysTrue` 错误详解：`!==` 恒为 true 的类型分析逻辑与修复方案

开发工具代码质量静态分析 【免费下载链接】phpstan PHP Static Analysis Tool - discover bugs in your code without running it! 项目地址&#xff1a; https://gitcode.com/gh_mirrors/ph/phpstan 点击查看 免费下载 本篇技术指南以 PHPStan 错误文档 notIdentical.always…

2026/9/24 12:08:06 阅读更多 →
本地空调安装哪家专业？

本地空调安装哪家专业？

商家与消费者的痛点做空调生意的商家常常发愁&#xff0c;旺季订单忙不过来&#xff0c;淡季又没什么单量&#xff1b;而且空调销售不只是卖设备&#xff0c;得提供专业的解决方案&#xff0c;这对销售能力要求高。消费者呢&#xff0c;挑空调时犯难&#xff0c;既要考虑匹数适…

2026/9/24 12:08:06 阅读更多 →
2026年医学文献检索工具实测：谁在真正改变临床医生的查文献方式？

2026年医学文献检索工具实测：谁在真正改变临床医生的查文献方式？

凌晨三点&#xff0c;值班医生面对一例复杂病例&#xff0c;脑子里冒出一连串问题——最新指南怎么说&#xff1f;这类罕见并发症有哪些循证依据&#xff1f;打开PubMed&#xff0c;输入关键词&#xff0c;面对几千条结果&#xff0c;逐条筛选、判断。这几乎是每一位临床医生都…

2026/9/24 12:08:06 阅读更多 →
返利规则“写死”在代码里，每次调整都要开发介入——配置化返利引擎该怎么设计？

返利规则“写死”在代码里，每次调整都要开发介入——配置化返利引擎该怎么设计？

返利政策调整&#xff0c;是服装品牌渠道运营中最高频的动作之一。这个季度推新品&#xff0c;返利比例调高&#xff1b;下个季度清库存&#xff0c;返利规则改成“按清仓款采购量返”&#xff1b;旺季冲量&#xff0c;增加“达量返点”&#xff1b;淡季保底&#xff0c;推出“…

2026/9/24 12:08:06 阅读更多 →
佛山家具产业带，设计师都在忙什么?

佛山家具产业带，设计师都在忙什么?

很多人想入行家具设计&#xff0c;但心里没底&#xff1a;这行到底什么样&#xff1f;天天坐办公室画图吗&#xff1f;工资怎么样&#xff1f;今天不聊软件、不聊培训&#xff0c;就聊聊佛山龙江、乐从这片家具产业带里&#xff0c;设计师们平时到底在忙什么。看完你对这行的真…

2026/9/24 12:07:05 阅读更多 →

日新闻

基于YOLOv8的渔船作业监控系统：从环境搭建到边缘部署全流程

基于YOLOv8的渔船作业监控系统：从环境搭建到边缘部署全流程

简介&#xff1a;这是一套面向计算机、人工智能、自动化等专业学生与教师的毕业设计级项目资源&#xff0c;围绕YOLOv8实现渔船作业监控系统&#xff0c;可用于毕设、课程设计、大作业或项目立项演示。压缩包共97个文件&#xff0c;约24.21MB&#xff0c;以70个Python源码文件为…

2026/9/24 0:00:19 阅读更多 →
单细胞注释实战：基于Scanpy的标记基因与参考映射流程解析

单细胞注释实战：基于Scanpy的标记基因与参考映射流程解析

简介&#xff1a;一份基于单细胞RNA测序数据的细胞类型注释算法研究Python毕业设计源码&#xff0c;针对计算机相关专业正在做毕设或需要项目实战的学习者&#xff0c;可用于课程设计与期末大作业。项目代码完整、经导师指导评审通过&#xff0c;可直接运行&#xff0c;覆盖数据…

2026/9/24 0:00:19 阅读更多 →
C#源生成器实战：用增量生成器替代反射，告别AOT崩溃

C#源生成器实战：用增量生成器替代反射，告别AOT崩溃

第一次在项目里被反射卡住&#xff0c;是在一个老旧的WinForms模块里&#xff1a;几十个类依赖PropertyChanged通知&#xff0c;运行时反射读属性、发通知&#xff0c;每次启动慢半拍不说&#xff0c;一上.NET Native/AOT裁剪模式几乎全面崩盘。后来我把这段逻辑全部改成C#源生…

2026/9/24 0:00:19 阅读更多 →

周新闻

Flutter for OpenHarmony游戏卡片渐变背景实战：从原理到性能优化

Flutter for OpenHarmony游戏卡片渐变背景实战：从原理到性能优化

直接铺开项目本身吧。这几个月我一直在折腾一件事&#xff1a;用Flutter给OpenHarmony做一款游戏集合类的App&#xff0c;说白了就是把若干小游戏塞进一个壳里&#xff0c;用统一入口分发。这个方向本身不算新鲜&#xff0c;真正让我花了不少心思的&#xff0c;是首页那堆游戏卡…

2026/9/23 4:55:02 阅读更多 →
Word表格编号全攻略：从列表编号到题注交叉引用

Word表格编号全攻略：从列表编号到题注交叉引用

写Word文档&#xff0c;最让人头疼的往往是那些“看起来不起眼”的小问题。比如表格编号这事&#xff1a;今天在表后面多加了两个空白行&#xff0c;明天给客户交稿前发现整个章节的编号全部错位&#xff0c;光是挨个改序号就能耗掉大半个下午。我前阵子帮人整理一份上百页的技…

2026/9/24 9:10:42 阅读更多 →
从第一个站到第二个站：独立开发者的静态网站选型与落地实践

从第一个站到第二个站：独立开发者的静态网站选型与落地实践

1. 项目概述1.1 核心需求解析做独立开发者这几年&#xff0c;说实话&#xff0c;第一个网站上线的那天晚上我兴奋得没睡着。但等它跑了半年&#xff0c;流量惨淡、功能臃肿、代码自己都懒得看第二遍之后&#xff0c;我才慢慢琢磨明白一个道理&#xff1a;第一个网站是练手&…

2026/9/23 9:53:41 阅读更多 →

月新闻

持续集成 流水线自动化与 声明式交付 实践：原型怎样变成可用功能

持续集成 流水线自动化与 声明式交付 实践：原型怎样变成可用功能

持续集成 流水线自动化与 声明式交付 实践&#xff1a;原型怎样变成可用功能分类&#xff1a;[AI/大模型]细分主题&#xff1a;AI 增强型 CI/CD 流水线自动化与 GitOps 实践&#xff1a;Agent 工作流、工具调用与任务拆解&#xff1a;从原型到生产的验收清单很多团队在尝试用大…

2026/9/23 9:53:40 阅读更多 →
容器编排 生产环境运维与排障实战：复盘记录怎样真正派上用场

容器编排 生产环境运维与排障实战：复盘记录怎样真正派上用场

容器编排 生产环境运维与排障实战&#xff1a;复盘记录怎样真正派上用场分类&#xff1a;[工程技术]细分主题&#xff1a;Kubernetes 生产环境运维与排障实战&#xff1a;可复制的项目复盘模板与决策记录大部分团队的事故复盘报告&#xff0c;最后都变成了躺在 Confluence 或钉…

2026/9/23 9:53:40 阅读更多 →
容器 容器化技术与镜像安全管理：核心链路应该先拆哪一步

容器 容器化技术与镜像安全管理：核心链路应该先拆哪一步

容器 容器化技术与镜像安全管理&#xff1a;核心链路应该先拆哪一步分类&#xff1a;[工程技术]细分主题&#xff1a;Docker 容器化技术与镜像安全管理&#xff1a;核心链路的逐步实现与关键代码取舍面对一个积累了五六年历史包袱的单体架构应用&#xff08;包含 Web 接口、后台…

2026/9/23 9:53:40 阅读更多 →