Part1：安裝 PyQt5

使用 PyQt5 開發(fā)界面，需要安裝兩個核心庫，直接通過 pip 命令即可完成安裝（注意這里針對的python版本是低于3.10的，高于3.10的版本有所變化），命令如下：

pip install PyQt5
pip install pyqt5-tools

若出現安裝超時、失敗等問題，可添加鏡像源加速下載，命令修改如下：

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

Part2：配置 PyQt5 的依賴工具 QtDesigner 和 PyUIC

QtDesigner 是可視化界面設計工具，PyUIC 是將 .ui 設計文件轉換為 Python 代碼的工具，需在 PyCharm 中進行配置，步驟如下：

1. 打開 PyCharm，依次點擊頂部菜單欄 File —> Settings —> Tools —> External Tools（外部工具）。
2. 點擊界面右側的 + 號，分別添加 QtDesigner 和 PyUIC 兩個工具（需對應你的 Python/Conda 環(huán)境路徑）。

   

配置 QtDesigner

核心是找到 designer.exe 的存放路徑，以 Python 環(huán)境為例，我的路徑如下：

C:\Users\26416\AppData\Local\Programs\Python\Python310-32\Lib\site-packages\qt5_applications\Qt\bin\designer.exe

配置 PyUIC

核心是找到 pyuic5.exe 的存放路徑，以 Python 環(huán)境為例，我的路徑如下：

C:\Users\26416\AppData\Local\Programs\Python\Python310-32\Scripts\pyuic5.exe

找不到路徑可以在解釋器這里查詢自己的環(huán)境路徑。

此外，配置時還需要填寫以下兩個關鍵參數（直接復制即可）：

• Arguments（參數）：$FileName$ -o $FileNameWithoutExtension$.py
• Working directory（工作目錄）：$FileDir$

Part3：使用 QtDesigner 設計界面

配置完成后，可通過兩種方式打開 QtDesigner：

1. 右鍵點擊當前項目工程文件，在彈出的菜單中找到 External Tools —> QtDesigner。
2. 直接點擊 PyCharm 頂部菜單欄 Tools —> External Tools —> QtDesigner。

   

打開 QtDesigner 后，操作流程如下：

1. 在彈出的新建界面窗口中，選擇 Main Window（主窗口），點擊 Create（創(chuàng)建）。

   

2. 進入設計界面后，左側為組件面板，中間為畫布，右側為屬性配置面板。

   

3. 從左側組件面板中拖動所需的常用組件（如按鈕、文本框、標簽等）到中間畫布，搭建自定義界面。

   

4. 可通過右側屬性面板，修改界面、組件的尺寸、名稱、顯示文本等屬性，完成界面精細化設計。

   

Part4：使用 PyUIC 將設計好的界面轉換為 .py 文件

界面設計完成后，先通過 Ctrl+S 保存設計文件（后綴為 .ui）。

再將其轉換為可被 Python 調用的 .py 文件，步驟如下：

1. 返回 PyCharm 項目界面，找到保存好的 .ui 設計文件。
2. 右鍵點擊該 .ui 文件，在彈出的菜單中選擇 External Tools —> PyUIC。
3. 執(zhí)行完成后，會在同一目錄下生成一個與 .ui 文件同名的 .py 文件，該文件中包含了界面的所有布局和組件信息，無需手動修改。

   

Part5：通過代碼顯示 UI 界面

下面提供一個通用模板，只需簡單修改一處，即可顯示你設計好的 UI 界面，代碼及注釋如下：

from PyQt5 import QtCore, QtGui, QtWidgets  # 導入PyQt5核心模塊
from PyQt5.QtCore import *  # 導入QtCore模塊，提供核心功能（如信號與槽、定時器等）
from PyQt5.QtGui import *  # 導入QtGui模塊，提供圖形相關功能（如字體、圖標等）
from PyQt5.QtWidgets import QFileDialog, QMainWindow, QMessageBox  # 導入常用窗口組件

'''
QFileDialog：幫助用戶可視化選擇文件/文件夾路徑
QMainWindow：用于創(chuàng)建帶有菜單、工具欄、狀態(tài)欄的標準主窗口
QMessageBox：用于向用戶顯示提示、警告、確認等彈窗信息
'''

""" 唯一需要修改的地方：將 test 替換為你的 .ui 文件轉換后的 .py 文件名 """
from test import Ui_MainWindow  # 導入生成的UI類，包含所有界面設計信息

import sys  # 導入sys模塊，用于處理應用程序命令行參數和退出邏輯

class PyQtMainEntry(QMainWindow, Ui_MainWindow):  # 定義主窗口類，繼承自QMainWindow和Ui_MainWindow
    def __init__(self):  # 構造函數，初始化窗口
        super().__init__()  # 調用父類構造函數，完成基礎初始化
        self.setupUi(self)  # 調用setupUi方法，加載并渲染設計好的界面

    """ 此處可編寫業(yè)務邏輯代碼，為界面中的組件（如按鈕）綁定點擊事件等功能 """

if __name__ == "__main__":
    app = QtWidgets.QApplication(sys.argv)  # 創(chuàng)建PyQt5應用程序實例
    window = PyQtMainEntry()  # 創(chuàng)建主窗口實例
    window.show()  # 顯示主窗口
    sys.exit(app.exec_())  # 進入應用程序事件循環(huán)，確保正常退出并清理資源

將代碼中的 from test import Ui_MainWindow 中的 test 替換為你的 .py 文件名，運行該代碼即可顯示你設計的 UI 界面。界面的大小、組件樣式等，均可在 QtDesigner 中自定義調整優(yōu)化。

最終效果：

總結 

到此這篇關于Python PyQt5安裝與配置詳細教程的文章就介紹到這了,更多相關PyQt5安裝與配置內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

最新評論