PyQT5环境搭建与入门操作（超详细图解安装）

PyQt5软件简介

PyQt5官方版是一款专业优秀的编程工具。PyQt5最新版需要配合Python使用，是Qt C++跨平台应用程序框架和跨平台解释语言Python的结合，支持Windows、OS X、Linux、iOS和Android平台运行。PyQt5软件可以帮助用户从Qt Designer生成Python代码，相当强大。

软件基础简介

      Qt是一套跨平台C++库，可实现高级API，用于访问现代桌面和移动系统的许多方面。这些包括位置和定位服务、多媒体、NFC和蓝牙连接，基于Chromium的网络浏览器以及传统的UI开发。PyQt5是Qt v5的一套全面的Python绑定。它被实现为超过35个扩展模块，并且使Python可以在所有支持的平台(包括iOS和Android)上用作C++的替代应用程序开发语言。PyQt5也可以嵌入在基于C++的应用程序中，以允许这些应用程序的用户配置或增强这些应用程序的功能。

软件特性

      1、软件包含许多插件，使Qt设计师使用Python代码扩展。看到编写Qt Designer插件和集成Python

      2、软件也包含了一些实用程序：

      pyuic5QT corresponds to theUIC功用它的转化qtwidgets使用Qt Designer对Python代码创建基于GUI 。

      pyrcc5QT corresponds to the碾压混凝土功用它将 任意资源(如图标、图片、翻译文件)的 资源集合在一个文件中的Python模块描述

      pylupdate5QT corresponds to thelupdate功用它 提取所有的可翻译字符串从Python代码和创建或更新 TS

      3、dbus.mainloop.pyqt5模块。该模块提供了 支持Qt的事件循环，以同样的方式，dbus.mainloop.glib包括与标准Python的总线绑定包提供了glib事件循环支持

      4、当软件配置文件名pyqt5.api生成。这 可以使用的qscintilla编辑组件启用自动完成使用和电话技巧当软件代码编辑。API文件自动安装如果qscintilla已经安装

      5、软件包括大量实例。这些港口的许多 的C例子提供了Qt的Python。他们可以找到的实例目录

      6、软件包含SIP协议。由SIP应用文件的生成本身。这些可以通过基于类 图书馆其他开发者使用Qt绑定。

软件优点

      pyqt5做为Python的一个模块，它有620多个类和6000个函数和方法。这是一个跨平台的工具包，它可以运行在所有主要的操作系统，包括UNIX，Windows，Mac OS。pyqt5是双重许可。开发者可以在GPL和商业许可之间进行选择。

      pyqt5的类别分为几个模块，包括以下：

      QtCore

      QtGui

      QtWidgets

      QtMultimedia

      QtBluetooth

      QtNetwork

      QtPositioning

      Enginio

      QtWebSockets

      QtWebKit

      QtWebKitWidgets

      QtXml

      QtSvg

      QtSql

      QtTest

安装步骤

1.安装PyQt5之前需要先安装python，安装python十分简单小编就不再累述了，安装的时候只需要注意有一个pip选项记得勾选就行了。（pip能够下载以及安装其他Python包）

2.安装完python之后我们可以在开始菜单或者桌面上看到python ide快捷方式，双击打开可以看到版本等信息，小编这里python 版本信息为3.6.1。接下来您可以从PyQt5官网或者本站下载PyQt5。

3.从本站下载解压之后发现解压后的文件是"PyQt5-5.8.2-5.8.0-cp35.cp36.cp37-none-win_amd64.whl"，这是一个whl文件，这时候就需要我们之前勾选的pip这个工具了。打开安装python时的安装目录，将该路径复制。

4.将该路径添加到你的系统或者用户，PATH变量值中去。

5.之后打开cmd，输入pip install wheel，将出现下图所示界面，表示安装wheel成功。（.whl就是需要wheel工具安装）

6.安装完wheel之后，进入PyQt5文件所在路径中，输入pip install PyQt5-5.8.2-5.8.0-cp35.cp36.cp37-none-win_amd64.whl。（小编PyQt5文件位于D：谷歌下载，文件名称为“PyQt5-5.8.2-5.8.0-cp35.cp36.cp37-none-win_amd64.whl”）

7.之后在任意目录中新建一个.py文件，在该文件中输入以下代码

import sys

from PyQt5 import QtWidgets, QtCore

app = QtWidgets.QApplication(sys.argv)

widget = QtWidgets.QWidget()

widget.resize(360, 360)

widget.setWindowTitle("Hello, PyQt5!")

widget.show()

sys.exit(app.exec_())

然后保存，将它拖动到python ide上。

8.如果出现下图所示界面，则表示PyQt5安装成功了。

PyQT5环境搭建与入门操作

1、pip工具

pip是Python的安装插件的工具，由它安装后的插件有两种情况。即安装全局插件和局部插件。

pip是python中自带的安装命令，它可以在线安装pyhton环境所需要的插件。

pip安装插件有两种方式，第一种在Pycharm编辑工具的终端中安装，这种安装方式属性局部用户安装（即局部安装），它只在当前项目中有效。

第二种在CMD终端中安装，它属于全局用户安装（即全局安装），经它安装后的插件可以在任何项目中使用。该方式安装好后会在Python的安装目录中Lib-->site-packages目录中生成所安装的资源；而局部安装不会在该目录生成相关安装资源。

如下图中使用pip3命令安装了pyqt5相关插件，site-packages目录中便生成相关资源文件。

使用Pycharm创建新项目时，需要勾选Inherit global site-packages选项才可以继承site-packages目录中的插件。

2、安装PyQT5相关插件

在CMD终端中安装，它属于全局用户安装（即全局安装），经它安装后的插件可以在任何项目中使用。该方式安装好后会在Python的安装目录中Lib-->site-packages目录中生成所安装的资源；而局部安装不会在该目录生成相关安装资源。

如下图中使用pip3命令安装了pyqt5相关插件，site-packages目录中便生成相关资源文件。

使用Pycharm创建新项目时，需要勾选Inherit global site-packages选项才可以继承site-packages目录中的插件。

Python的中使用pip命令安装插件，安装插件时pip命令会检测命令是否兼容，如果不兼容终端会提供更新后再安装，更新方式如下：

python -m pip install --upgrade pip

待pip更新后即可以安装插件，下面以安装pyqt5插件为例子。

安装PyQT5插件

安装PyQT5工具包

安装Pyqt5语法检测包（可不安装）

检验是否成功安装，可使用以下命令：

pip3 list

3、在PyCharm中配置QT

首先创建一个新的项目（过程参考1处方法），然后打开File-->Settings，根据下图验证Python的编译环境是否无误；一般Python环境会自动检测，如果没有自动检测出，可以使用1处下拉，手动的设置Python的运行位置。

待Python环境无误后，即可以添加新的外部工具，需要添加Qt Designer和PyUIC两个外部工具。其中Qt Designer是用于启动QT的可视化编程；而PyUIC是用来将QT Designer代码转化成Python代码。

它们两个外部工具的安装方法一样，首先选择File --> settings --> Tools -- External Tools，并点击“+”号添加外部工具。

3.1 添加Qt Designer外部工具，点击加号，进入添加界面，需要添加内容如下图。

注意：

Name为外部工具的名字，可以自定义。

Program为designer.exe可执行程序的地址。该地址是pip命令使用全局方式安装好QT相关的插件后自动生成的，该文件的版本不同位置存放的地址不同，可以借助搜索工具进行查看。designer.ext其实就是Qt开发工具的安装路径。

Working directory为工作路径，在编辑框中填写“$ProjectFileDir$”即可，固定写法。

3.2 添加PyUIC外部工具

PyUIC工具是用于将Qt Designer代码转化为Python代码的工具，添加方式与Qt Designer一样，点击加号，进入添加界面，需要添加内容如下图。

其中Arguments属性是用于设置将ui文件转为py文件的代码，代码格式固定，需要按以下方式填写。

-m PyQt5.uic.pyuic $FileName$ -o $FileNameWithoutExtension$.py

Working directory中的值为“$FileDir$”固定写法。

到此，Python、Qt和Pycharm三个开发工具的环境就整合在一起了。

4、初步使用Qt Designer工具

首先在Pycharm中点击Tools --> External Tools --> Qt Designer工具。

启动Qt Designer工具后的界面如下图所示。

5、创建第一个PyQT5项目

5.1打开Qt Designer开发工具

由于之前将Python、Pycharm和Qt Designer开发工具给整合在一起，所以可以借助Pycharm开发工具打开Qt Designer工具；在Pycharm中点击Tools --> External Tools --> Qt Dsigner按钮，进入到Qt Dsigner开发界面，如下图所示。

5.2编写第一个PyQT程序

在QT Designer开发工具中点击新建（默认自动出现），选择Main Window选择并点击“创建”按钮，生成一个新的QT页面。

生成的新页面如下图所示，当前页面是否保存，并且只有默认名状态，等程序逻辑编写完成后，可以按Ctrl + S键保存该文件。

接下来编写页面内容，下面以一个简单的测试做为例子，在左边“控件”找到Label控制，并选中拖拽到窗口中，将其内容修改为“欢迎使用PYQT5”，如下图所示。

使用Ctrl + C按键，将该文件保存到项目中，如下图所示。

选中该文件（QtTest.ui），单击鼠标右键，选择External Tools --> PyUIC选项，将QtTest.ui文件转为QtTest.py文件，如下图所示。

生成py文件后结果如下图所示。

5.3运行QtTest.py程序

由于生的QtTest.py文件中没有程序主入口，所示要向运行该文件该先创建主入口main方法。main可以写在当前文件中，也可写在另外一个文件中，建议将main方法写在另外一个文件中，因为QtTest.ui修改后，要生成QtTest.py文件时，每次生成将是以覆盖方式生成，会导致每次都要写main方法，相当麻烦，所以建议将该方法写在另一个文件中，这样就不会被覆盖，如下图所示。

要想运行该文件，还需要在main方法中编写相应代码，如下图所示。

5.4打包

5.4.1 安装插件

在第3点中提到的运行方式是在线运行，用于开发时能快速看到运行结果时使用，实际部署时应该将该文件打包是“.exe”后缀的可执行文件，然后双击运行，接下来将讲解在Pycharm中将项目打包成exe文件。

Pycharm中需要先安装pyinstaller插件才能打包Python可执行文件，安装方式有两种，可以在控制台终端安装，如下示例：

pip3 install pyinstaller

也可以使用图型化界面安装，首先选择File --> Settings --> Project:项目名-->Python Interpreter选项，点击“+”号添加新的插件，如下图所示。

安装好后，可以使用pip list查看安装的效果，如下图所示。

5.4.2 开始打包

在Pycharm的控制终端中输入“pyinstaller -F -w MainTest.py”命令进行打包。其中pyinstalle是打包命令。

详细说明如下：

pyinstaller --paths PyQt5模块路径 -F -w --icon=窗口图标文件路径 文件名.py

--paths:指定第三方模块的安装路径

--icon：可选，设置窗口图标

-F, –onefile 打包一个单个文件，如果你的代码都写在一个.py文件的话，可以用这个，如果是多个.py文件就别用

-D, –onedir 打包多个文件，在dist中生成很多依赖文件，适合以框架形式编写工具代码，

-K, –tk 在部署时包含 TCL/TK

-a, –ascii 不包含编码.在支持Unicode的python版本上默认包含所有的编码.

-d, –debug 产生debug版本的可执行文件

-w,–windowed,–noconsole 使用Windows子系统执行.当程序启动的时候不会打开命令行(只对Windows有效)

-c,–nowindowed,–console 使用控制台子系统执行(默认)(只对Windows有效)

打包完成后，会在当前项目中生成一个后缀为exe的可执行文件，双击该文件即可以运行python项目，如下图所示。