【Qt 信号与槽使用自定义类型】出现 --错误：LNK2001 无法解析的外部符号

---

解决 Qt 信号与槽中 const std::vector<Detection>& 引发的 LNK2001 错误的步骤

问题分析

错误 LNK2001 表明链接器找不到信号或槽函数的定义，常见原因如下：

1. 自定义类型未注册到 Qt 元系统：当信号或槽的参数包含 std::vector<Detection> 时，若未通过 qRegisterMetaType 注册，跨线程或队列连接时会导致序列化失败。
2. 信号与槽声明不匹配：参数类型（如 const 修饰符、引用 &）未严格一致。
3. Detection 类未正确定义：缺少默认构造函数、拷贝构造函数或必要的元类型支持。

---

解决方案

1. 注册自定义类型到 Qt 元系统

在连接信号与槽之前（通常在 main.cpp 或类的构造函数中），注册 std::vector<Detection> 和 Detection：

#include <QMetaType>
#include "Detection.h" // 确保包含 Detection 的头文件

// 在 main 函数或初始化代码中注册
int main(int argc, char *argv[]) {
    QApplication a(argc, argv);
    
    // 注册 Detection 和 std::vector<Detection>
    qRegisterMetaType<Detection>("Detection");
    qRegisterMetaType<std::vector<Detection>>("std::vector<Detection>");
    
    // 若需要支持信号槽跨线程传递，还需注册为元类型流
    qRegisterMetaTypeStreamOperators<Detection>("Detection");
    qRegisterMetaTypeStreamOperators<std::vector<Detection>>("std::vector<Detection>");
    
    MainWindow w;
    w.show();
    return a.exec();
}

2. 确保 Detection 类的元类型支持

在 Detection.h 中声明必要的构造函数和元类型宏：

#include <QMetaType>

class Detection {
public:
    Detection() = default; // 必须提供默认构造函数
    Detection(const Detection&) = default; // 必须提供拷贝构造函数

    // 其他成员函数和数据成员...
};

// 注册 Detection 为元类型（需在头文件末尾）
Q_DECLARE_METATYPE(Detection)
Q_DECLARE_METATYPE(std::vector<Detection>) // 声明 vector 的元类型

3. 检查信号与槽的声明

确保信号和槽的参数类型完全一致（包括 const 和 &）：

// 信号声明（在头文件中）
signals:
    void signalDetected(const std::vector<Detection>& detections);

// 槽声明（在头文件中）
public slots:
    void slotHandleDetection(const std::vector<Detection>& detections);

4. 在 .pro 文件中启用 C++11 或更高标准

Qt 的元类型系统需要 C++11 支持以处理标准库容器：

# 在 .pro 文件中添加
CONFIG += c++11

5. 连接信号与槽时使用正确语法

使用 Qt5 的新式连接语法（基于函数指针）以增强类型安全：

// 在类初始化代码中（如构造函数）
connect(
    senderObj, &SenderClass::signalDetected,
    receiverObj, &ReceiverClass::slotHandleDetection
);

---

完整代码示例

Detection.h

#ifndef DETECTION_H
#define DETECTION_H

#include <QMetaType>
#include <vector>

class Detection {
public:
    Detection() = default;
    Detection(int x, int y) : x(x), y(y) {}
    Detection(const Detection& other) = default;

    int x = 0;
    int y = 0;
};

Q_DECLARE_METATYPE(Detection)
Q_DECLARE_METATYPE(std::vector<Detection>)

#endif // DETECTION_H

MainWindow.h

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>
#include <vector>
#include "Detection.h"

class MainWindow : public QMainWindow {
    Q_OBJECT

public:
    MainWindow(QWidget *parent = nullptr);

signals:
    void signalSendDetections(const std::vector<Detection>& detections);

public slots:
    void slotReceiveDetections(const std::vector<Detection>& detections);
};

#endif // MAINWINDOW_H

MainWindow.cpp

#include "MainWindow.h"
#include <QDebug>

MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) {
    // 注册元类型（若未在 main 中注册）
    qRegisterMetaType<std::vector<Detection>>("std::vector<Detection>");

    // 连接信号与槽
    connect(
        this, &MainWindow::signalSendDetections,
        this, &MainWindow::slotReceiveDetections
    );

    // 示例：发送信号
    std::vector<Detection> detections{ {1,2}, {3,4} };
    emit signalSendDetections(detections);
}

void MainWindow::slotReceiveDetections(const std::vector<Detection>& detections) {
    for (const auto& d : detections) {
        qDebug() << "Detection: (" << d.x << "," << d.y << ")";
    }
}

main.cpp

#include "MainWindow.h"
#include <QApplication>
#include "Detection.h"

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);
    
    // 注册自定义类型
    qRegisterMetaType<Detection>("Detection");
    qRegisterMetaType<std::vector<Detection>>("std::vector<Detection>");
    
    MainWindow w;
    w.show();
    return a.exec();
}

---

常见问题排查

1. 未在连接前注册类型：确保在连接信号与槽之前调用 qRegisterMetaType。
2. Detection 类缺少默认构造函数：必须提供 Detection() 或 Detection(const Detection&)。
3. 参数类型不匹配：信号和槽的参数类型必须严格一致（如 const std::vector<Detection>& vs std::vector<Detection>）。
4. 未在 .pro 中启用 C++11：添加 CONFIG += c++11。

---

总结

通过注册自定义类型、确保信号槽参数一致，并正确配置项目，可解决 LNK2001 错误。此方法适用于所有需要跨线程或队列传递非Qt内置类型的场景。