Qt | Cross-platform software development for embedded & desktop
PyQt Documentation v6.3.0 (riverbankcomputing.com)
关键字：Qt Python QtSide PyQt6 GUI PyCharm pyinstaller nuitka

image.png

前言

GUI开发里大名鼎鼎的Qt，C++开发，支持跨平台跨设备。对Python也有完善API支持，如果工作中有快速开发GUI的需求，然后正好后台服务是python的话，那PyQt就是绝配了。
PyQt目前已支持最新的Qt6，网上教程大多还是PyQt5，建议直接学习最新的PyQt6。
官方Qt的亲儿子是PySide，建议直接学习最新的PySide6（支持Qt6）。

Qt开发步骤：

1. 设计GUI，图形化拖拽或手撸
2. 响应UI的操作（如点击按钮、输入数据、服务器更新），使用信号与Slot连接界面和业务
3. 打包发布

安装

如果不是开发Andriod等设备app，无需下载几个G的Qt，直接pip安装pyqt包就行，大概占用300MB空间，也包含了Qt Designer, PyUiC，qmlscene，qmltestrunner等工具。
目前PyQt最新是6.3.0，对应Qt为6.2。
Python IDE大家选自己顺手的就行，这里以PyCharm为例。

Ubuntu

pip install --upgrade pip
pip install PyQt6 pyqt6-tools

Windows安装

需要注意下，有时安装后会出现ERROR: ImportError: DLL load failed while importing QtGui告警，应该是pip安装时处理包依赖有小问题，以如下步骤安装：

# 创建虚拟环境：venv，或pipenv
pip install --upgrade pip
pip install PyQt6
# 备份PyQt6目录到其他处：c:\users\kevinqq\.virtualenvs\pyqt6-demo\Lib\site-packages\PyQt6\
pip install pyqt6-tools
# 恢复PyQt6到原始目录

第一个Qt程序

#!/usr/bin/python
import sys
from PyQt6.QtWidgets import QApplication, QWidget, QPushButton

def main():
    app = QApplication(sys.argv)
    w = QWidget()
    w.setWindowTitle('Simple')
    btn = QPushButton('Hello PyQt6!', w)
    btn.move(50, 50)
    w.show()
    sys.exit(app.exec())

if __name__ == '__main__':
    main()

image.png

一套代码，Windows和Linux下都可运行，是不是很nice。

PyCharm配置

配置两个工具

1. QtDesigner 图形化拖拽来设计GUI
   打开Pycharm，按快捷键Ctrl+Atl+S，打开设置界面，然后在工具选项里找到外部工具

   
   image.png
2. PyUiC
   这个是把designer生成的UI文件转化为py文件的工具
   程序：填Python目录下的\Scripts\pyuic6.exe
   实参：$FileName$ -o $FileNameWithoutExtension$.py
   工作目录：$FileDir$

完成后，在PyCharm目录上点右键：External Tools，就能直接启动QtDesigner 6.1.0或PyUiC了。

image.png image.png

如果不使用PyCharm，用命令行运行，效果也是一样的。

PyQt打包成exe可执行文件

pip install pyinstaller
pip install auto-py-to-exe

运行：auto-py-to-exe

image.png

1. Script Location：选择要打包的py主程序
2. One File：选生成单一文件
3. 不显示命令行窗口
4. Icon可设置图标
5. Advanced下，可设置UPX（从这里下载 https://upx.github.io/）

然后点击“Convert .PY to .EXE”就会自动生成.exe文件了，在当前目录output子目录下。

image.png

大小为26MB，比纯C++开发的肯定大不少，但换来的是快速开发。如果有要极致性能要求，可以等原型开发完后，再用C改写。

• 复杂程序用UPX压缩后会缩小不少，这里试了下，选upx压缩选项后为22MB
• Linux下打包后为47MB，貌似更大，暂时未去调查

[2022-5-24更新] 打包的话，用nuitka更适合，对PySide支持更好。压缩后仅15MB左右。

pip install nuitka zstandard
# PyQt 26MB ==> 14.9MB
python -m nuitka --onefile --windows-disable-console --enable-plugin=pyqt6 <your_app>.py
# PySide 34MB ==> 16.8MB
python -m nuitka --onefile --windows-disable-console --enable-plugin=pyside6 <your_app>.py

[2022-5-24更新] PyQt与PySide的选择：

• PyQt
  PyQt要比PySide推出时间早得多，开发商是Riverbank Computing，GPLv3协议，如果闭源商用就会违反协议，后果自负。
• PySide
  Qt for Python Documentation - Qt for Python
  对比PyQt，PySide就要晚得多问世了，但它是Qt的亲儿子，使用LGPL协议，可免费。目前PySide6已经很完善了，包括文档。
  如果你不想开源你的代码，而又想免费使用Qt ，那选择哪个很明显了吧？两者语法基本一样的，绝大多数程序直接把import PyQt6换成import PySide6就可以了，不用担心学习浪费。

---

参考：

pyqt6 - PyQt 中文教程 (gitbook.io)
PyQt6和pyqt6-tools在PyCharm2021的详细配置方法装