PyQt5与PyQt5 Designer：Python GUI开发利器入门指南

字节客栈

于 2025-05-22 08:00:00 发布

阅读量639

点赞数 15

分类专栏： Python 小书文章标签： qt python 开发语言

本文链接：https://blog.csdn.net/snail915/article/details/148126295

版权

Python 小书专栏收录该内容

6 篇文章

订阅专栏

PyQt5与PyQt5 Designer：Python GUI开发利器入门指南

一、什么是PyQt5和PyQt5 Designer？

PyQt5是Python语言的一套GUI编程工具包，它把著名的Qt框架（C++库）封装成了Python可调用的模块。Qt框架由Qt Company开发，被广泛应用于各种桌面应用程序的开发。

PyQt5 Designer是PyQt5配套的可视化界面设计工具，它允许开发者通过拖拽组件的方式快速构建用户界面，无需手动编写大量布局代码。

为什么选择PyQt5？

跨平台：Windows、macOS、Linux全支持
功能强大：提供超过600个类，上万种功能
美观现代：支持多种样式和主题
商业友好：GPL和商业许可双选择

二、PyQt5能做什么？

PyQt5几乎可以开发任何类型的桌面应用程序：

办公工具：文本编辑器、PDF工具、办公自动化
多媒体应用：音乐播放器、视频编辑器
数据可视化：图表展示、数据分析工具
教育软件：教学辅助、考试系统
工业应用：设备控制面板、监控系统

三、环境安装与配置

1. 安装PyQt5

pip install PyQt5

2. 安装设计工具

pip install PyQt5-tools

安装完成后，Designer工具通常位于Python安装目录下的Lib\site-packages\qt5_applications\Qt\bin文件夹中。

四、PyQt5 Designer快速上手

1. 启动Designer

在命令行输入：

pyqt5designer

或者直接找到designer.exe运行。

2. 认识Designer界面

https://example.com/designer-ui.jpg

主要区域：

组件面板：左侧各种UI组件
主设计区：中央的空白窗体
属性编辑器：右侧组件属性设置
对象查看器：右下角组件层级关系

3. 创建一个简单窗口

选择"Main Window"模板
从左侧拖拽几个组件：
- 一个Label（显示文字）
- 一个Line Edit（输入框）
- 一个Push Button（按钮）
使用布局工具排列组件
保存为.ui文件（如mywindow.ui）

五、从UI文件到Python代码

Designer生成的.ui文件需要转换为Python代码：

pyuic5 -x mywindow.ui -o mywindow.py

或者可以在代码中动态加载：

from PyQt5 import uic
Form, Window = uic.loadUiType("mywindow.ui")

六、完整示例：简易计算器

1. 使用Designer创建界面

创建包含：

两个LineEdit（输入数字）
一个ComboBox（选择±*/）
一个PushButton（计算）
一个Label（显示结果）

保存为calculator.ui。

2. 转换UI文件

pyuic5 -x calculator.ui -o calculator.py

3. 添加业务逻辑

修改生成的calculator.py：

from PyQt5 import QtWidgets
from PyQt5.QtWidgets import QMessageBox

class CalculatorWindow(QtWidgets.QMainWindow):
    def __init__(self):
        super().__init__()
        self.ui = Ui_MainWindow()
        self.ui.setupUi(self)
        
        # 连接按钮点击事件
        self.ui.calculateBtn.clicked.connect(self.calculate)
        
    def calculate(self):
        try:
            num1 = float(self.ui.num1Edit.text())
            num2 = float(self.ui.num2Edit.text())
            op = self.ui.operatorBox.currentText()
            
            if op == '+':
                result = num1 + num2
            elif op == '-':
                result = num1 - num2
            elif op == '*':
                result = num1 * num2
            elif op == '/':
                result = num1 / num2 if num2 != 0 else '∞'
                
            self.ui.resultLabel.setText(f"结果: {result}")
            
        except ValueError:
            QMessageBox.warning(self, "错误", "请输入有效数字")

if __name__ == "__main__":
    import sys
    app = QtWidgets.QApplication(sys.argv)
    window = CalculatorWindow()
    window.show()
    sys.exit(app.exec_())

4. 运行程序

python calculator.py

你将看到一个功能完整的简易计算器！

七、PyQt5开发进阶技巧

信号与槽机制：Qt的核心特性，实现组件间通信
```
button.clicked.connect(self.handle_click)
```
多线程处理：避免界面卡死
```
from PyQt5.QtCore import QThread
```

样式美化：使用QSS（Qt样式表）

self.setStyleSheet("QPushButton { background-color: red; }")

国际化：支持多语言
```
self.tr("可翻译文本")
```

八、PyQt5 Designer使用技巧

快捷键：
- Ctrl+R：预览窗口
- F3：设置伙伴关系（Label与输入框关联）
布局管理：
- 使用布局工具（水平、垂直、网格）而非绝对位置
- 设置大小策略让组件自适应
资源管理：
- 使用资源文件(.qrc)管理图片等资源
- 转换为Python代码：pyrcc5 resources.qrc -o resources.py