在QWizard中使用自定义FileWidget时向导未接收值变更通知的问题

核心问题是你的FileWidget中filename是普通Python变量，而非Qt元对象系统可识别的属性，导致QWizard无法追踪其变化。以下是修复步骤：

1. 将filename改为Qt属性 #

使用pyqtProperty装饰器把filename声明为Qt属性，同时关联fileChanged信号，让Qt能感知值的变更：

from PyQt6.QtWidgets import QWidget, QHBoxLayout, QLineEdit, QPushButton, QFileDialog, QWizard, QWizardPage, QFormLayout
from PyQt6.QtCore import pyqtSignal, pyqtProperty
import pathlib

class FileWidget(QWidget):
    fileChanged = pyqtSignal(str)

    def __init__(self):
        super().__init__()
        self._filename = ""  # 用实例私有变量存储实际值，避免类变量共享问题

        layout = QHBoxLayout(self)
        self.__file_edit = QLineEdit()
        self.__file_edit.setEnabled(False)
        layout.addWidget(self.__file_edit)

        self.__file_button = QPushButton("Select Template")
        self.__file_button.clicked.connect(self.__open_file_dlg)
        layout.addWidget(self.__file_button)

    # 声明Qt属性，指定类型和通知信号
    @pyqtProperty(str, notify=fileChanged)
    def filename(self):
        return self._filename

    # 属性的setter方法，处理值更新和信号发射
    @filename.setter
    def filename(self, value):
        if self._filename != value:
            self._filename = value
            self.__file_edit.setText(value)
            self.fileChanged.emit(value)

    def __open_file_dlg(self, *args):
        selected_file = QFileDialog.getOpenFileName(
            self,
            "Select file",
            str(pathlib.Path.home().absolute()),
            "Documents (*.docx)"
        )[0]
        self.filename = selected_file  # 调用setter，自动触发信号和UI更新

2. 保留QWizard的配置（无需修改） #

你的QWizard初始化代码可以保留，setDefaultProperty已经正确关联了属性和信号：

wizard = QWizard()
wizard_page = QWizardPage()
wizard_page.setLayout(QFormLayout())

wizard.addPage(wizard_page)

widget = FileWidget()
wizard.setDefaultProperty(FileWidget.__name__, "filename", FileWidget.fileChanged)
wizard_page.layout().addRow("File Name:", widget)
wizard_page.registerField("filename*", widget)

wizard.show()
wizard.exec()

为什么这样能解决问题？ #

• Qt的registerField依赖Qt属性系统来同步字段值，普通Python变量无法被Qt元对象系统追踪。
• pyqtProperty将filename注册到Qt元对象系统，结合notify=fileChanged，当属性值变化时会自动通知QWizard更新字段。
• 把原来的类属性filename改为实例私有变量_filename，避免多个FileWidget实例共享同一值的问题。

内容的提问来源于stack exchange，提问作者Shelling