Pycharm+PyQt5配置GUI开发环境

我们在使用PyQt5进行开发的过程中，会使用到很多工具命令，例如pyuic、pyrcc、pyinstaller等。同时还会使用Qt界面设计器。在pycharm中，我们可以通过设置External Tools命令来配置外部命令，这样就能方便我们进行界面开发工作。以下我对这些命令进行总结配置，方便以后查询，同时也提供给大家参考。

Qt Creator

下载Qt Creator

Qt Creator只是界面编辑器，有些教程里要下载Qt编译器，这个有点太大了，而且我们只是使用其中界面编辑功能，所以这个Qt Creator就很适合了。当然在Windows系统里，可以通过pip install pyqt5-tools安装后就可以使用qtdesigner.exe了。

配置Qt Designer命令

Program: 配置Qt Designer软件地址。如果是Windows系统，则在python安装目录下Scripts/qtdesigner.exe文件即可。

这个命令是通过PyCharm快捷打开Qt Designer软件

配置Qt Designer-Current命令

Program：配置Qt Designer软件地址。 Arguments：$FileName$ 表示当前右键选中的文件 Working directory：$FileDir$ 表示当前选中文件所在目录。

上面已经添加了Qt Designer命令为什么还要这个命令呢？一个是打开Qt Designer软件，一个是用Qt Designer软件打开当前选中文件。根据自己需求添加吧。

配置PyUIC命令

Program：$PyInterpreterDirectory$/pyuic5 找到pyuic5所在目录，PyInterpreterDirectory是一个宏，表示当前工程的Python环境路径，可以使用后面的Insert Macro…进行添加

选择宏以后，下面会显示当前宏表示的值。 Arguments：-o $FileNameWithoutExtension$.py $FileName$

这个命令是把.ui文件转化为.py文件。 pyuic5命令的使用方式为：pyuic5 -o src.ui dst.py，最后生成dst.py文件，src.ui文件是Qt Creator生成的布局文件。

配置PyRcc5命令

Program： $PyInterpreterDirectory$/pyrcc5 Arguments：-o $FileNameWithoutAllExtensions$.py $FileName$

这个命令是把资源文件.qrc转换为.py文件。命令：pyrcc5 -o xxx.qrc xxx.py

为什么要使用资源文件？

我们在使用PyQt5设置控件图片等资源时，一般可以直接使用相对路径进行加载。直接使用代码中进行加载。

# -*- coding: utf-8 -*-
import sys
from PyQt5 import QtWidgets, QtGui

class Form(QtWidgets.QDialog):
    def __init__(self, parent=None):
        super(Form, self).__init__(parent)
        layout = QtWidgets.QVBoxLayout()

        self.btn = QtWidgets.QPushButton("image")
        self.btn.setIcon(QtGui.QIcon(QtGui.QPixmap("images/player.ico")))
        layout.addWidget(self.btn)
        self.setLayout(layout)

if __name__ == '__main__':
    app = QtWidgets.QApplication(sys.argv)
    windows = Form()
    windows.show()
    sys.exit(app.exec_())

上面的加载方式，在我们打包的以后，资源不能正常显示，而且当你把软件拷贝到其他地方使用的时候，还要是只有一个exe文件好呢？还是要带上各种.png、.ico、.qss文件好呢？当然是前者了。因此qrc资源文件就产生了。

我在Mac上使用的Qt Creator没有资源文件编辑功能，我看了一下Qt Creator生成的.qrc文件的格式

<!DOCTYPE RCC>
<RCC version="1.0">
    <qresource>
        <file alias="icons/add.png">icons/add.png</file>
        <file alias="icons/appicon.png">icons/appicon.png</file>
        <file alias="icons/button.png">icons/button.png</file>
        <file alias="qss/qss.qss">qss/qss.qss</file>
    </qresource>
</RCC>

生成了images.py文件

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

# Resource object code
#
# Created by: The Resource Compiler for PyQt5 (Qt v5.12.2)
#
# WARNING! All changes made in this file will be lost!

from PyQt5 import QtCore

qt_resource_data = b"
x00x00x06xda
x00
x00xcex7ex78x9cxedx9dx0bx8cx5cx53x18xc7xbfx55x2c
x2dxd6xfbx59xeax4dx48x51xf1x8cxc8xb6xdexafx78x04
x11x41x28xdbxa6xe2x55x22xd2x78x64x47x52x82x04x21
x08x25x51x6fx42xc4x6bx4bx44x68x94x20xa4x1ex0dxf1
x68xb4xdex44xb1x9ex5dxacx5dxdfxe7x8cxeexdcx9dx39
......此处省略10000字

qt_version = [int(v) for v in QtCore.qVersion().split('.')]
if qt_version < [5, 8, 0]:
    rcc_version = 1
    qt_resource_struct = qt_resource_struct_v1
else:
    rcc_version = 2
    qt_resource_struct = qt_resource_struct_v2

def qInitResources():
    QtCore.qRegisterResourceData(rcc_version, qt_resource_struct, qt_resource_name, qt_resource_data)

def qCleanupResources():
    QtCore.qUnregisterResourceData(rcc_version, qt_resource_struct, qt_resource_name, qt_resource_data)

qInitResources()

这时候就可以放弃图片文件了，使用生成的images.py文件作为图片资源。加载图片使用冒号加文件路径。 :./images/player.ico

# -*- coding: utf-8 -*-
import sys
from PyQt5 import QtWidgets, QtGui
import images

class Form(QtWidgets.QDialog):
    def __init__(self, parent=None):
        super(Form, self).__init__(parent)
        layout = QtWidgets.QVBoxLayout()

        self.btn = QtWidgets.QPushButton("image")
        self.btn.setIcon(QtGui.QIcon(QtGui.QPixmap(":./images/player.ico")))
        layout.addWidget(self.btn)
        self.setLayout(layout)

if __name__ == '__main__':
    app = QtWidgets.QApplication(sys.argv)
    windows = Form()
    windows.show()
    sys.exit(app.exec_())

使用import images导入，使用:./images/player.ico引用。

我们可以写一个脚本，自动生成qrc资源文件。

import os
import sys

def gen_images_resource(res_path):
    res_name = os.path.dirname(res_path)
    fp = open("images.qrc", 'w+')
    fp.write('<!DOCTYPE RCC>n<RCC version="1.0">n    <qresource>n')
    for root, dirs, files in os.walk(res_path):
        for file in files:
            sub_path = os.path.join(root, file)
            fp.write("        {}/{}n".format(res_name, sub_path[len(res_path):]))
    fp.write("    </qresource>n</RCC>")
    fp.close()

if __name__ == '__main__':
    res_path = sys.argv[1]
    gen_images_resource(res_path)

可以将此脚本配置成类似PyUIC这种命令

配置PyInstaller命令

Program：$PyInterpreterDirectory$/pyinstaller Arguments：--paths C:/xxx/Lib/site-packages/PyQt5/Qt/bin -F -w $FileName$ 因为我系统的路径和一般的不太一样，我就不用在这里误导大家了。

使用PyInstaller打包PyQt5文件，因为无法识别Qt动态文件路径，会导致程序打开失败。因此打包的时候，我们要指定PyQt的库文件地址：

pyinstaller --paths C:/xxx/Lib/site-packages/PyQt5/Qt/bin -F -w xxx.py