1. 前言

https://m.toutiao.com/is/JGSHc2X/

博主是一名有几年开发经验的Python社畜。网上关于pyQt5的资料实际上也不少，但大都是对某个具体问题的讨论，比较零散。而我在写代码的过程中经常遇到各种各样的问题，这使得我经常在数十个网站上查询资料，很不友好。为此我决定写这篇文章，详细记录一下从零到一的过程，也希望以此抛砖引玉，向大佬们学习

以下是demo演示

可以看到这个朴实无华的工具效果图……
虽然很简陋，但是我需要的基本功能还是实现了。demo的内容大致包含：事件的触发、文件读取写出、进度条异步线程和信号等等，作为第一个gui项目内容应该足够了，业务逻辑的代码根据功能不同也可以随意替换，算是迈出了第一步

1.1 注意事项

这篇博客可能适合以下老哥阅读：

有一些python基础
会装python环境和第三方库安装
基本没使用过或者不太懂pyQt5开发

就像题目所说的那样，这篇博客是类似于新手教程的东西，虽然写的是从零开始，但是不打算过多介绍关于环境和软件安装的相关问题（这方面的教程确实太多了）。另外如果你已经是python或pyqt的老手了，我不确定我写的东西会不会对你有用，当然也欢迎留下意见

2. 准备工作

2.1 关于环境

Python：Python 3.7.9 Anaconda 环境
windows 10
IDE: Pycharm
PyQT5 + QtDesigner

2.2 安装pyqt库

2.2.1 新建虚拟环境（已经有python环境了跳过此步骤）

以管理员身份运行Anaconda Navigator，进入CMD Prompt

输入下面的命令创建一个python3.7版本的虚拟环境，环境名为pygui。这里的pygui可以更改

conda create -n pygui python=3.71

出现如下界面输入y继续安装，即可成功安装

安装完成后输入下面的语句检查环境是否安装成功

conda env list1

如图所示，名为pygui已经成功安装

输入下面的语句激活pygui环境（可以理解为切换到pygui环境下）

activate pygui1

如图所示，当前环境由base切换到pygui虚拟环境

至此，新建虚拟环境就算是成功了。这部分与博客内容无关，因此不过多赘述

2.2.2 安装pyqt的包

注：如果是非Anaconda环境把下文中出现的conda xxx命令替换为pip xxx
使用命令安装PyQt5

pip install PyQt51

下图为正在安装的界面，如有Proceed输入y。安装的速度取决与网速和源，我用的清华源也超时了好几次，多试几次如果依然超时建议更换源或者设置超时时间

安装完成后输入下面的命令检查包的安装情况

conda list1

应该有下图中的包

python 3.5以上版本安装成功后还需安装pyqt5-tools

pip install pyqt5-tools1

安装成功后虚拟环境的库如下图所示（这里根据版本不同，包的数量和名称可能会略有区别，只要安装成功了一般不影响后面使用）

启动Qtdesigner，直接输入designer命令即可启动Qt设计师

designer1

如下图所示，如果无法启动则说明安装有问题。启动成功后先不要关闭命令窗口，后面编译ui文件还会用到

2.2.3 使用designer新建demo

创建MainWinodw 界面基本结构如图所示

在组件菜单里选择Label拖动到画布里
双击Label组件进入编辑模式
输入文本信息按回车就编辑成功了
Ctrl + S重命名并保存到桌面

现在桌面上应该有一个.ui类型的文件了，下一步需要将ui文件编译为py文件。
打开之前的命令窗口，使用cd命令切换到ui文件所在的目录下，我这里是桌面
使用下面的命令编译ui文件。注意这里export.ui是我刚才保存的ui文件，如果文件名不是export.ui需要自行替换，export.py是将要生成的py文件，建议设置为与ui文件相同的名称

pyuic5 -o export.py export.ui1

执行成功后当前目录下应该有一个py文件了，如下图所示

如果上面的步骤出现错误大概率是pyqt包安装问题

2.3 在pycharm中配置环境和pyqt插件

1. 关于环境，使用不同的IDE则需要不同的步骤，只要能让项目在新建的pygui环境下运行就行
2. pyqt的插件仅仅是方便在pycharm中使用pyqt的功能，使用命令也能达到相同的效果

2.3.1 新建项目使用虚拟环境

启动pycharm ——> New Project 操作步骤如下图所示

在环境选择界面选择conda虚拟环境

创建

2.3.2 配置qt插件

项目创建完毕后开始配置qt插件
点击File ——> Setting
在弹出界面中选择 Tools下的 External Tools 进行配置，如下图所示

在弹出的界面中进行如下配置，此为Designer配置

配置如下

Name: QtDesignerGroup: QtProgram: xxxxx\xxxxxx\designer.exeWorking Directory: $ProjectFileDir$1234

这里重点说一下第三步
Program填写designer.exe的绝对路径，这里的路径因人而异，如果跟我一样是使用Anaconda创建的虚拟环境那么路径应该跟下面这条路径类似

C:\ProgramData\Anaconda3\Library\bin\designer.exe1

如果是使用系统的python环境那么应该类似于下面这条

C:\Users\xxxx\AppData\Local\Programs\Python\Python37\Lib\site-packages\pyqt5-tools\designer.exe1

配置完成后可在菜单栏 Tools ——> Qt ——> QtDesigner 打开designer，如果无法打开则说明配置有误，如下

配置Pyuic，如法炮制

配置如下

Name: pyUICGroup: QtProgram: xxxxx\xxxxxx\pyuic5.exeArguments: $FileName$ -o $FileNameWithoutExtension$.pyWorking Directory: $FileDir$12345

同样，这里的Program也需要根据自己的路径修改，Anaconda环境类似于：

C:\ProgramData\Anaconda3\envs\pygui\Scripts\pyuic5.exe1

如果是使用系统的python环境那么应该类似于下面这条

C:\Users\xxxx\AppData\Local\Programs\Python\Python37\Scripts\pyuic5.exe1

配置完成后将之前我们生成的ui文件拷贝到项目中，选中ui文件，再使用菜单栏启动pyuic5编译ui文件，如下图所示

注意：一定要选中了ui文件再运行PyUic

2.3.3 运行项目

py文件已经能够编译出来，接下来就是运行了。
打开我们刚刚编译好的export.py会发现里面没有程序入口的代码，这是因为PyUic只会生成在designer中定义的东西，所以还需要加入程序入口的代码。
这里我建议另起一个main.py作为程序入口和业务逻辑的实现，这样就可以实现UI和业务逻辑分离，否则一旦修改了UI重新生成就会将之前的py文件全部覆盖，十分不友好
所以我们新建main.py 加入程序入口相关的代码
我的main.py代码如下
注意：xxxxx为刚才生成的py文件名称，我这里是export，根据情况替换

import sysfrom PyQt5.QtWidgets import QApplication, QMainWindowimport xxxxxclass Example(QMainWindow): def __init__(self): self.app = QApplication(sys.argv) super().__init__() self.ui = xxxxx.Ui_MainWindow() self.ui.setupUi(self) # 初始化 self.init_ui() # ui初始化 def init_ui(self): # 初始化方法，这里可以写按钮绑定等的一些初始函数 self.show()# 程序入口if __name__ == '__main__': e = Example() sys.exit(e.app.exec())

在这里我新建了Example类，借由操作Example来操作export里的Ui_MainWindow对象，这样做的目的是将业务逻辑和函数绑定相关工作全部交给Example，将UI、程序入口、业务逻辑完全分离，方便拓展，这样也符合OOP思想。
现在我们终于可以运行这个qt项目了，直接运行main.py文件应当能看到之前新建的ui界面，如图所示

PythonpyQt5适于新手上路（第一篇环境和配置）

1. 前言

1.1 注意事项

2. 准备工作

2.1 关于环境

2.2 安装pyqt库

2.2.1 新建虚拟环境（已经有python环境了跳过此步骤）

2.2.2 安装pyqt的包

2.2.3 使用designer新建demo

2.3 在pycharm中配置环境和pyqt插件

2.3.1 新建项目使用虚拟环境

2.3.2 配置qt插件

2.3.3 运行项目

over

PythonpyQt5适于新手上路（第一篇环境和配置）

1. 前言

1.1 注意事项

2. 准备工作

2.1 关于环境

2.2 安装pyqt库

2.2.1 新建虚拟环境（已经有python环境了跳过此步骤）

2.2.2 安装pyqt的包

2.2.3 使用designer新建demo

2.3 在pycharm中配置环境和pyqt插件

2.3.1 新建项目使用虚拟环境

2.3.2 配置qt插件

2.3.3 运行项目

over

相关推荐