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

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

简介

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

Part 1: 安装PyQt5

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

1. 打开终端或命令提示符。

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

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

3. 使用pip安装PyQt5和pyqt5-tools：

   pip install PyQt5 pyqt5-tools
   

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

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

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

Part 2: PyCharm配置PyQt5

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

1. 打开PyCharm，进入“File” -> “Settings” -> “Tools” -> “External Tools”。

2. 点击“+”添加新工具，配置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$。

3. 配置完成后，你可以通过PyCharm访问Qt Designer。

Part 3: 设计第一个UI

使用Qt Designer设计UI：

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

Part 4: 将UI转换为Python代码

1. 在Qt Designer中完成设计后，保存.ui文件。

2. 使用PyUIC工具将.ui文件转换为Python代码：

   pyuic5 your_ui_file.ui -o output_py_file.py
   

3. 创建一个新的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_())
   

4. 运行main.py，你将看到设计的用户界面，并且按钮点击事件已经可以正常工作。

结语

本教程为你提供了一个完整的PyQt5入门流程，从安装到配置，再到设计UI和编写应用逻辑。PyQt5的世界非常广阔，你可以继续探索更多的组件和布局，甚至学习如何将应用程序打包发布。希望这个教程能够帮助你开启PyQt5的学习之旅。