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的學習之旅。