pyQt5环境的搭建及开发设计

1、PyQt5 及 pyqt5-tools 安装

PyQt可以在所有主流操作系统上运行（Unix，Windows，Mac），可直接用pip安装

pip install PyQt5
pip install pyqt5-tools

建议使用国内资源，可以快速安装：

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pyqt5
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pyqt5-tools

2、PyCharm配置环境

启动PyCharm，新建一个PyQt5空项目后，需要配置Qt Designer、pyuic、pyrcc工具。

2.1、Qt Designer 是图形化用户界面的图形设计器，通过拖拽的方式放置控件，并实时查看控件效果进行快速UI设计。

在Pycharm中，依次打开 File - Settings - Tools - External Tools，点击 + Create Tool，配置如下：

Name: QtDisigner
Program : C:\Python37\Lib\site-packages\pyqt5_tools\Qt\bin\designer.exe # 当前designer目录，请根据实际修改
Working directory: $FileDir$

2.2、Qt Designer 汉化(若有必要)

默认Qt Designer是英文版的，可以使用翻译文件进行汉化。
下载文件 designer_zh_CN.qm后， 拷贝至本地pyqt5_tools的translations文件夹下即可，示例目录如：

C:\Python38\Lib\site-packages\pyqt5_tools\Qt\bin\translations

在PyCharm主界面，依次点击 Tools - External Tools - QtDisigner，即可启动中文界面的Qt Disigner

2.3、PyUIC配置

PyUIC主要是把Qt Designer生成的.ui文件换成.py文件。

在Pycharm中，依次打开 File - Settings - Tools - External Tools，点击 + Create Tool，配置如下：

Name: PyUIC
Program : C:\Python37\python.exe # 当前Python目录，请根据实际修改
Arguments: -m PyQt5.uic.pyuic $FileName$ -o $FileNameWithoutExtension$.py
Working directory: $FileDir$

2.4、 PyRCC配置

PyRCC主要是把编写的.qrc资源文件换成.py文件。

在Pycharm中，依次打开 File - Settings - Tools - External Tools，点击 + Create Tool，配置如下：

Name: PyRCC
Program : C:\Python38\Scripts\pyrcc5.exe # 当前rcc工具目录，请根据实际修改
Arguments: $FileName$ -o $FileNameWithoutExtension$_rc.py
Working directory: $FileDir$

$FileDir$（$FileDir$是在当前目录下将.ui文件生成.py文件，而$ProjectFileDir$是在总目录树下生成

2、代码开发-QtDesigner编写

3.1、启动QtDesigner
界面如下图所示：

新建一个MainWindow并且拖动一个组件如:Push Button

然后将其保存成ui文件。

3.2、转成py文件

需要在转成的py文件加入以下内容才能运行：

import sys

if __name__ == '__main__':
    app = QtWidgets.QApplication(sys.argv) #每一pyqt5应用程序必须创建一个应用程序对象。sys.argv参数是一个列表，从命令行输入参数。
    MainWindow = QtWidgets.QMainWindow() #QWidget部件是pyqt5所有用户界面对象的基类。他为QWidget提供默认构造函数。
    ui = Ui_MainWindow()
    ui.setupUi(MainWindow)
    MainWindow.show()
    sys.exit(app.exec_()) #进入程序主循环，窗口不会关闭，并且exit函数确保主循环安全退出

最终py文件如下：

# -*- coding: utf-8 -*-

# Form implementation generated from reading ui file 'test.ui'
#
# Created by: PyQt5 UI code generator 5.13.0
#
# WARNING! All changes made in this file will be lost!


from PyQt5 import QtCore, QtGui, QtWidgets
import sys


class Ui_MainWindow(object):
    def setupUi(self, MainWindow):
        MainWindow.setObjectName("MainWindow")
        MainWindow.resize(800, 600)
        self.centralwidget = QtWidgets.QWidget(MainWindow)
        self.centralwidget.setObjectName("centralwidget")
        self.pushButton = QtWidgets.QPushButton(self.centralwidget)
        self.pushButton.setGeometry(QtCore.QRect(220, 180, 75, 23))
        self.pushButton.setObjectName("pushButton")
        MainWindow.setCentralWidget(self.centralwidget)
        self.menubar = QtWidgets.QMenuBar(MainWindow)
        self.menubar.setGeometry(QtCore.QRect(0, 0, 800, 23))
        self.menubar.setObjectName("menubar")
        MainWindow.setMenuBar(self.menubar)
        self.statusbar = QtWidgets.QStatusBar(MainWindow)
        self.statusbar.setObjectName("statusbar")
        MainWindow.setStatusBar(self.statusbar)

        self.retranslateUi(MainWindow)
        QtCore.QMetaObject.connectSlotsByName(MainWindow)

    def retranslateUi(self, MainWindow):
        _translate = QtCore.QCoreApplication.translate
        MainWindow.setWindowTitle(_translate("MainWindow", "MainWindow"))
        self.pushButton.setText(_translate("MainWindow", "PushButton"))


if __name__ == '__main__':
    app = QtWidgets.QApplication(sys.argv)
    MainWindow = QtWidgets.QMainWindow()
    ui = Ui_MainWindow()
    ui.setupUi(MainWindow)
    MainWindow.show()
    sys.exit(app.exec_())

运行py文件，效果如下：

4、代码开发-代码编写

QtDesigner中的函数槽并不是非常全面，因此有些时候还需要代码硬编写，直接开发出py文件。

5、踩坑：关于PyCharm中执行脚本出现ModuleNotFoundError: No module named 'PyQt5’问题的解决方案

最新版的PyCharm，因为高版本pycharm自己创建了一个Python虚拟环境 默认没有把你安装的第三方库添加进来，所以就造成这种问题，而且在新建项目时候Project Iterpreter那个标签隐藏，无法注意到，需要手动打开，如下图中绿色那个小东西打开。

解决办法1:
在新建项目的时候如下图所示勾选那两个框框，目的是加载第三方库，这样在创建完工程的时候会加载一堆东西。

另一个办法就是利用下面的Existing interpreter来处理。点击那个配置按钮。

如果已经建了项目，不想重新再重复已有的工作，别担心，还有办法！

解决办法2：
在已有项目的最后面找到External Libraries ，然后找到venv目录，把pyvenv.cfg文件中的如下参数改成true

include-system-site-packages = true

如果你没有找到pyvenv.cfg，那么在你的settings->projiect interpreter目录所在处，找到该文件，用记事本修改完后，保存即可