【零基础学 PyQt5:环境搭建、Qt Designer 配置、UI 转 PY、窗口开发全流程】

张开发
2026/4/16 1:29:33 15 分钟阅读

分享文章

【零基础学 PyQt5:环境搭建、Qt Designer 配置、UI 转 PY、窗口开发全流程】
目录1.1 什么是 Qt Designer1.2什么是PyQt51.3 打开方式1.4搭建PyQt5开发环境1.5配置Qt Designer1.6配置PyUIC1.7ui转py的过程1.8开发第一个基于PyQt5的桌面应用1.1 什么是 Qt DesignerQt Designer 是 可视化界面设计工具随 PyQt5 自动安装。它的作用不用写代码用鼠标拖拽就能设计出漂亮的 GUI 界面。你只需要1. 打开 Qt Designer2. 从左侧拖按钮、输入框、标签到窗口3. 调整大小、颜色、字体4. 保存成 .ui 文件5. 一键转成 Python 代码1.2什么是PyQt5PyQt5 是 Qt 框架的 Python 绑定版本是目前 Python 生态中最成熟、最稳定、企业最常用的 GUI图形用户界面开发库。PyQt5 能做什么窗口、按钮、输入框、标签表格、列表、菜单图片显示、摄像头实时画面图表、数据可视化机器学习模型界面计算器、播放器、管理系统工业软件、客户端工具几乎所有桌面软件的界面PyQt5 都能做。1.3 打开方式安装 PyQt5 后自带在命令行输入designer即可打开也可在 PyCharm 中配置外部工具一键打开并转换 UI 文件1.4搭建PyQt5开发环境工具PythonPyQt5模块PyCharm在PyCharm里面安装PyQt5pip install PyQt5 -i https://pypi.douban.com/simple在PyCharm里面安装Qt 的工具包pip install PyQt5-tools -i https://pypi.douban.com/simple1.5配置Qt Designer打开 PyCharm进入 文件 → 设置 → 工具 → 外部工具File → Settings → Tools → External Tools。2. 点击左上角 号新建外部工具。3. 在「编辑工具」窗口中填写配置◦ 名称QtDesigner◦ 程序填写 designer.exe 的完整路径示例C:\ProgramData\anaconda3\Library\bin\designer.exe需替换为你本地的实际路径◦ 实参留空◦ 工作目录填写 $FileDir$宏变量自动定位当前项目目录4. 勾选「在执行后同步文件」「打开工具输出的控制台」点击「确定」保存。5. 可选按同样方式配置 PyUIC 工具实现 .ui 文件一键转 .py 代码。配置完成后即可在 PyCharm 菜单栏「工具 → External Tools」中直接启动 Qt Designer无需手动打开程序提升开发效率。我的版本已经配置好的按照这个步骤来就好1.6配置PyUIC打开 PyCharm → 文件File→ 设置Settings→ 工具Tools→ 外部工具External Tools点击 新建工具。2. 编辑工具窗口填写核心参数◦ 名称填 PyUIC◦ 程序选择本地 Anaconda/Python 解释器路径如 C:\ProgramData\anaconda3\python.exe◦ 实参填 $FileName$ -o $FileNameWithoutExtension$.py◦ 工作目录填 $FileDir$3. 高级选项中勾选「在执行后同步文件」「打开工具输出的控制台」点击「确定」保存。4. 配置完成后右键项目中的 .ui 文件通过「外部工具 → PyUIC」即可一键生成同名 .py 界面代码。1.7ui转py的过程1.点击EXternal Tools里面的QTDesigner会跳转到QT界面拖动组件调整好界面保存为first文件它会默认生成first.ui文件选中文件鼠标右击打开扩展选择PyUIC,它会生成.py文件将.ui文件转化为.py文件的命令行方法python -m PyQt5.uic.pyuic demo.ui -o demo.py1.8开发第一个基于PyQt5的桌面应用必须使用两个类: QApplication和QWidget。都在PyQt5.QtWidgets。 第一个类表示应用程序第二个类表示窗口# -*- coding: utf-8 -*- # Form implementation generated from reading ui file first.ui # # Created by: PyQt5 UI code generator 5.15.10 # # WARNING: Any manual changes made to this file will be lost when pyuic5 is # run again. Do not edit this file unless you know what you are doing. # 开发第一个基于PyQt5的桌面应用 import sys from PyQt5.QtWidgets import QApplication,QWidget if __name__ __main__: # 创建QApplication类的实例 app QApplication(sys.argv) # 创建一个窗口 w QWidget() # 设置窗口尺寸 宽度300高度150 w.resize(400,200) # 移动窗口 w.move(300,300) # 设置窗口的标题 w.setWindowTitle(第一个基于PyQt5的桌面应用) # 显示窗口 w.show() # 进入程序的主循环并通过exit函数确保主循环安全结束(该释放资源的一定要释放) sys.exit(app.exec_()) from PyQt5 import QtCore, QtGui, QtWidgets class Ui_Form(object): def setupUi(self, Form): Form.setObjectName(Form) Form.resize(400, 300) self.retranslateUi(Form) QtCore.QMetaObject.connectSlotsByName(Form) def retranslateUi(self, Form): _translate QtCore.QCoreApplication.translate Form.setWindowTitle(_translate(Form, Form))运行结果也可以在命令行运行python 文件名.py

更多文章