Qt 信號槽報錯：no such signal QListWidget::itemClicked(QListWidgetItem*) 解決指南

錯誤原因

QListWidget 並**沒有**名為 itemClicked(QListWidgetItem*) 的信號。
正確信號簽名為：

• void itemClicked(QListWidgetItem *item) —— **單擊項目**（Qt 5/6 均存在）
• void itemPressed(QListWidgetItem *item) —— 按下項目
• void itemActivated(QListWidgetItem *item) —— 雙擊/激活項目
• void itemEntered(QListWidgetItem *item) —— 滑入項目

報錯常見於：**手寫信號簽名拼寫錯誤**、**連接時參數類型不匹配**、**訪問權限導致 MOC 未識別**。

修復檢查清單

1. 拷貝官方簽名：直接從 Qt 文檔/頭文件複製 itemClicked(QListWidgetItem*)，勿手輸。
2. 連接代碼規範：

   // Qt5 新式連接（編譯期檢查，推薦）
   connect(ui->listWidget, &QListWidget::itemClicked, this, &MyClass::onItemClicked);
   
   // 舊式字符串連接（運行期解析，易拼錯）
   connect(ui->listWidget, SIGNAL(itemClicked(QListWidgetItem*)), this, SLOT(onItemClicked(QListWidgetItem*)));
   

3. 槽函數簽名完全一致：void onItemClicked(QListWidgetItem *item)，參數類型、const 屬性、引用/指針必須完全一致。
4. 類聲明檢查：
   • 類繼承 QObject 並含 Q_OBJECT 宏。
   • 槽函數聲明在 public slots: / private slots: / protected slots: 區塊，或用 Q_SLOT 標記（Qt5+）。
   • 構建系統執行 qmake → make / nmake / mingw32-make 重新生成 MOC 代碼。
5. 訪問控制：信號槽連接不受 public/private/protected 限制，但槽函數必須可被 MOC 見到（即聲明在類定義內）。

調試技巧

• 編譯輸出查看 moc_*.cpp 是否包含該槽的元對象信息。
• 運行時 QObject::connect 返回 false 並在控制台輸出 QObject::connect: No such signal...，直接定位拼寫差異。

核心原則：**信號簽名必須與類定義完全一致**，新式連接語法可在編譯期攔截 99% 此類錯誤，強烈建議全面遷移至新式連接。