PyQt5入门教程：从安装到构建简单应用

简介

PyQt5是一个功能强大的Python绑定库，用于Qt应用程序框架。它允许我们使用Python语言快速开发跨平台的桌面应用程序。本教程将引导你完成PyQt5的安装、配置，并带你创建一个简单的图形用户界面（GUI）应用程序。

Part 1: 安装PyQt5

在你的开发环境中安装PyQt5：

打开终端或命令提示符。

创建并激活虚拟环境（可选，但推荐）：

python -m venv myenv
myenv\Scripts\activate  # Windows
source myenv/bin/activate  # macOS/Linux

使用pip安装PyQt5和pyqt5-tools：

pip install PyQt5 pyqt5-tools

如果下载速度慢，可以指定国内镜像源：

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

使用pip list确认PyQt5是否已安装。

Part 2: PyCharm配置PyQt5

在PyCharm中配置PyQt5，以便使用Qt Designer设计UI：

打开PyCharm，进入“File” -> “Settings” -> “Tools” -> “External Tools”。
点击“+”添加新工具，配置Qt Designer、PyUIC和Pyrcc。
- QtDesigner：
  - 名称：QtDesigner
  - 程序：designer.exe的路径（例如：C:\Python39\Lib\site-packages\PyQt5\Qt\bin\designer.exe）。
  - 工作目录： $FileDir$ 。
- PyUIC：
  - 名称：PyUIC
  - 程序：Python解释器的路径。
  - 实参：-m PyQt5.uic.pyuic $FileName$ -o $FileNameWithoutExtension$.py。
  - 工作目录： $FileDir$ 。
- Pyrcc：
  - 名称：Pyrcc
  - 程序：Python解释器的路径。
  - 实参：-rcc $FileName$ -o $FileNameWithoutExtension$_rc.py。
  - 工作目录： $FileDir$ 。
配置完成后，你可以通过PyCharm访问Qt Designer。

Part 3: 设计第一个UI

使用Qt Designer设计UI：

打开Qt Designer，选择“Main Window”并创建新窗口。
在“Widget Box”中选择组件，拖拽到设计画布上。
使用“属性编辑器”修改组件的属性。
完成设计后，使用快捷键Ctrl + R预览UI。

Part 4: 将UI转换为Python代码

在Qt Designer中完成设计后，保存.ui文件。
使用PyUIC工具将.ui文件转换为Python代码：
```
pyuic5 your_ui_file.ui -o output_py_file.py
```

创建一个新的Python脚本，例如main.py，引入QApplication和QMainWindow，并使用转换后的UI类创建应用程序：

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow
import your_ui_file  # 替换为你的.ui转换后的模块名class MainWindow(QMainWindow, your_ui_file.Ui_MainWindow):def __init__(self):super().__init__()self.setupUi(self)# 添加按钮点击事件self.pushButton.clicked.connect(self.on_pushButton_clicked)def on_pushButton_clicked(self):print("按钮被点击了！")if __name__ == '__main__':app = QApplication(sys.argv)mainWindow = MainWindow()mainWindow.show()sys.exit(app.exec_())