Part1：安裝 PyQt5

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

pip install PyQt5
pip install pyqt5-tools

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

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 是可視化界面設(shè)計(jì)工具，PyUIC 是將 .ui 設(shè)計(jì)文件轉(zhuǎn)換為 Python 代碼的工具，需在 PyCharm 中進(jìn)行配置，步驟如下：

1. 打開 PyCharm，依次點(diǎn)擊頂部菜單欄 File —> Settings —> Tools —> External Tools（外部工具）。
2. 點(diǎn)擊界面右側(cè)的 + 號(hào)，分別添加 QtDesigner 和 PyUIC 兩個(gè)工具（需對(duì)應(yīng)你的 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)境路徑。

此外，配置時(shí)還需要填寫以下兩個(gè)關(guān)鍵參數(shù)（直接復(fù)制即可）：

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

Part3：使用 QtDesigner 設(shè)計(jì)界面

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

1. 右鍵點(diǎn)擊當(dāng)前項(xiàng)目工程文件，在彈出的菜單中找到 External Tools —> QtDesigner。
2. 直接點(diǎn)擊 PyCharm 頂部菜單欄 Tools —> External Tools —> QtDesigner。

   

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

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

   

2. 進(jìn)入設(shè)計(jì)界面后，左側(cè)為組件面板，中間為畫布，右側(cè)為屬性配置面板。

   

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

   

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

   

Part4：使用 PyUIC 將設(shè)計(jì)好的界面轉(zhuǎn)換為 .py 文件

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

再將其轉(zhuǎn)換為可被 Python 調(diào)用的 .py 文件，步驟如下：

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

   

Part5：通過代碼顯示 UI 界面

下面提供一個(gè)通用模板，只需簡(jiǎn)單修改一處，即可顯示你設(shè)計(jì)好的 UI 界面，代碼及注釋如下：

from PyQt5 import QtCore, QtGui, QtWidgets  # 導(dǎo)入PyQt5核心模塊
from PyQt5.QtCore import *  # 導(dǎo)入QtCore模塊，提供核心功能（如信號(hào)與槽、定時(shí)器等）
from PyQt5.QtGui import *  # 導(dǎo)入QtGui模塊，提供圖形相關(guān)功能（如字體、圖標(biāo)等）
from PyQt5.QtWidgets import QFileDialog, QMainWindow, QMessageBox  # 導(dǎo)入常用窗口組件

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

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

import sys  # 導(dǎo)入sys模塊，用于處理應(yīng)用程序命令行參數(shù)和退出邏輯

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

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

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

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

最終效果：

總結(jié) 

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

最新評(píng)論