Python-PyQt5 安装与配置教程

在弹出的新建界面窗口中，选择 Main Window（主窗口），点击 Create（创建）。
进入设计界面后，左侧为组件面板，中间为画布，右侧为属性配置面板。
从左侧组件面板中拖动所需的常用组件（如按钮、文本框、标签等）到中间画布，搭建自定义界面。
可通过右侧属性面板，修改界面、组件的尺寸、名称、显示文本等属性，完成界面精细化设计。

Part4：使用 PyUIC 将设计好的界面转换为 .py 文件

界面设计完成后，先通过 Ctrl+S 保存设计文件（后缀为 .ui）。

再将其转换为可被 Python 调用的 .py 文件，步骤如下：

返回 PyCharm 项目界面，找到保存好的 .ui 设计文件。
右键点击该 .ui 文件，在弹出的菜单中选择 External Tools ---> PyUIC。
执行完成后，会在同一目录下生成一个与 .ui 文件同名的 .py 文件，该文件中包含了界面的所有布局和组件信息，无需手动修改。

Part5：通过代码显示 UI 界面

下面提供一个通用模板，只需简单修改一处，即可显示你设计好的 UI 界面，代码及注释如下：

python 复制代码

from PyQt5 import QtCore, QtGui, QtWidgets  # 导入PyQt5核心模块
from PyQt5.QtCore import *  # 导入QtCore模块，提供核心功能（如信号与槽、定时器等）
from PyQt5.QtGui import *  # 导入QtGui模块，提供图形相关功能（如字体、图标等）
from PyQt5.QtWidgets import QFileDialog, QMainWindow, QMessageBox  # 导入常用窗口组件

'''
QFileDialog：帮助用户可视化选择文件/文件夹路径
QMainWindow：用于创建带有菜单、工具栏、状态栏的标准主窗口
QMessageBox：用于向用户显示提示、警告、确认等弹窗信息
'''

""" 唯一需要修改的地方：将 test 替换为你的 .ui 文件转换后的 .py 文件名 """
from test import Ui_MainWindow  # 导入生成的UI类，包含所有界面设计信息

import sys  # 导入sys模块，用于处理应用程序命令行参数和退出逻辑

class PyQtMainEntry(QMainWindow, Ui_MainWindow):  # 定义主窗口类，继承自QMainWindow和Ui_MainWindow
    def __init__(self):  # 构造函数，初始化窗口
        super().__init__()  # 调用父类构造函数，完成基础初始化
        self.setupUi(self)  # 调用setupUi方法，加载并渲染设计好的界面

    """ 此处可编写业务逻辑代码，为界面中的组件（如按钮）绑定点击事件等功能 """

if __name__ == "__main__":
    app = QtWidgets.QApplication(sys.argv)  # 创建PyQt5应用程序实例
    window = PyQtMainEntry()  # 创建主窗口实例
    window.show()  # 显示主窗口
    sys.exit(app.exec_())  # 进入应用程序事件循环，确保正常退出并清理资源

将代码中的 from test import Ui_MainWindow 中的 test 替换为你的 .py 文件名，运行该代码即可显示你设计的 UI 界面。界面的大小、组件样式等，均可在 QtDesigner 中自定义调整优化。

最终效果：

Python-PyQt5 安装与配置教程

目录

Part1：安装 PyQt5

Part2：配置 PyQt5 的依赖工具 QtDesigner 和 PyUIC

配置 QtDesigner

配置 PyUIC

Part3：使用 QtDesigner 设计界面

Part4：使用 PyUIC 将设计好的界面转换为 .py 文件

Part5：通过代码显示 UI 界面