在 PyQt 加載 UI 三種常見方法

更新時間：2025年05月12日 11:43:56 作者：戀戀西風

在PyQt中,加載UI文件通常指的是使用Qt Designer設計的.ui文件,并將其轉換為Python代碼,以便在PyQt應用程序中使用,這篇文章給大家介紹在PyQt加載UI三種常見方法,感興趣的朋友一起看看吧

方法一：使用 uic 模塊動態(tài)加載（不推薦用于大型項目）

雖然不推薦使用這種方法（因為它每次都會重新加載UI文件，這在大型項目中可能導致性能問題），但了解它也是有益的。你可以使用uic.loadUi()函數直接在運行時加載UI文件。

from PyQt5 import QtWidgets, uic
class MyWindow(QtWidgets.QMainWindow):
    def __init__(self):
        super().__init__()
        # 加載 UI 文件
        uic.loadUi('your_ui_file.ui', self)  # 第二個參數 self 表示將控件加載到當前窗口
app = QtWidgets.QApplication([])
window = MyWindow()
window.show()
app.exec_()

方法二：將 UI 文件編譯為 Python 模塊后導入

首先，確保你已經安裝了pyqt5-tools或pyqt6-tools（取決于你使用的PyQt版本）。然后，可以使用命令行工具將.ui文件轉換為Python代碼。

首先使用 pyuic5 工具將 .ui 文件編譯為 .py 文件：

pyuic5 your_ui_file.ui -o ui_yourfile.py

2. 然后在代碼中導入生成的模塊：

from PyQt5 import QtWidgets
from ui_yourfile import Ui_MainWindow  # 假設你的主窗口類名為 Ui_MainWindow
class MyWindow(QtWidgets.QMainWindow):
    def __init__(self):
        super().__init__()
        # 設置 UI
        self.ui = Ui_MainWindow()
        self.ui.setupUi(self)
app = QtWidgets.QApplication([])
window = MyWindow()
window.show()
app.exec_()

方法3：使用uic模塊直接在代碼中加載UI文件

從PyQt5和PyQt6開始，可以直接在Python代碼中使用uic.loadUiType()函數來加載.ui文件，而不需要先將其轉換為Python代碼。

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow
from PyQt5 import uic
# 加載UI文件
Ui_MainWindow, QtBaseClass = uic.loadUiType('your_ui_file.ui')
class MyApplication(QMainWindow, Ui_MainWindow):
    def __init__(self):
        super(MyApplication, self).__init__()
        self.setupUi(self)  # 初始化UI
app = QApplication(sys.argv)
window = MyApplication()
window.show()
sys.exit(app.exec_())

注意事項

確保 UI 文件路徑正確，可以使用絕對路徑或相對路徑
動態(tài)加載方式不需要預先編譯 UI 文件，但執(zhí)行時會稍微慢一點
如果 UI 文件中包含自定義控件，需要確保這些控件在 Python 代碼中可用
推薦使用方法一或方法三的動態(tài)加載方式，這樣修改 UI 文件后不需要重新編譯

信號槽連接示例

class MyWindow(QtWidgets.QMainWindow):
    def __init__(self):
        super().__init__()
        uic.loadUi('your_ui_file.ui', self)
        # 連接信號槽
        self.pushButton.clicked.connect(self.on_button_click)
    def on_button_click(self):
        print("Button clicked!")

以上方法都可以實現直接加載 UI 文件，選擇哪種方式取決于你的項目需求和個人偏好。