如何消除QWizard::addPage()时的QObject::connect非信号绑定警告

首先，这个警告的核心原因是QWizard内部会自动尝试连接QWizardPage派生类中Q_PROPERTY对应的NOTIFY信号，但你的代码里要么信号名称拼写错误，要么信号没有正确声明为Qt的信号，导致Qt无法识别它是合法的信号。

从你给出的警告信息TreeView::ndex_changed来看，首先要注意到这里的信号名是ndex_changed——明显是index_changed的拼写错误（少了字母i），这大概率是触发警告的直接原因。下面是具体的排查和修复步骤：

1. 检查Q_PROPERTY的NOTIFY信号拼写 #

找到你自定义QWizardPage派生类（比如TreeView）中的Q_PROPERTY定义，确认NOTIFY字段的信号名是否正确。比如正确的写法应该是：

// 示例：正确的Q_PROPERTY定义
Q_PROPERTY(int index READ index WRITE setIndex NOTIFY index_changed)

如果这里写成了NOTIFY ndex_changed，就会导致Qt去寻找一个不存在的信号，触发警告。

2. 确保NOTIFY信号是合法的Qt信号 #

即使拼写正确，也要确认信号是否符合Qt的信号规则：

• 必须在类的signals:区域声明，不能有访问修饰符（public/private等，signals默认是public的）
• 信号返回值必须是void
• 信号不能有函数体（Qt MOC会自动生成实现）
• 信号的参数要和属性的类型兼容（如果需要传递新值的话）

示例正确的信号声明：

class TreeView : public QWizardPage
{
    Q_OBJECT
    Q_PROPERTY(int index READ index WRITE setIndex NOTIFY index_changed)

public:
    explicit TreeView(QWidget *parent = nullptr);
    int index() const;
    void setIndex(int newIndex);

signals:
    // 正确的信号声明，无函数体，返回void
    void index_changed(int newIndex); // 如果需要传递新值，参数类型要和属性匹配
    // 或者不需要参数的话：void index_changed();
};

3. 验证MOC是否正确生成信号 #

如果你修改了信号或Q_PROPERTY的定义，记得重新编译整个项目，确保Qt的MOC工具重新生成了对应的信号代码。有时候旧的MOC生成文件会导致奇怪的问题。

4. 排查属性名称冲突 #

虽然可能性较低，但如果你的属性名称index和QWizard或QWizardPage内部的某个属性重名，也可能导致异常。可以尝试临时修改属性名称（比如改成pageIndex），看看警告是否消失，来验证这一点。

按照上面的步骤排查后，这个警告应该就能消除了。

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