单编译单元下Qt程序出现Undefined reference to vtable链接错误求助

你遇到的链接错误本质是Qt的**元对象编译器（MOC）**没有生成必要代码导致的，这是Qt特有的机制，和纯C的编译逻辑完全不同：

核心原因 #

Qt的信号槽、反射等功能依赖元对象系统，只要类里加了Q_OBJECT宏，就需要MOC生成额外的辅助代码（包含元对象相关的虚函数实现，这些代码会被合并到类的vtable中）。

• 拆分文件时：mainwindow.h里的Q_OBJECT会被qmake/MOC自动扫描，生成moc_mainwindow.cpp并参与编译链接，所以vtable是完整的。
• 合并到main.cpp后：MOC默认只扫描头文件，不会处理.cpp文件里的Q_OBJECT宏，因此缺少了元对象相关的代码，链接器找不到vtable里对应的条目，就报了错。

解决办法 #

手动处理MOC（适合手动g++编译） #

1. 先对main.cpp运行MOC生成辅助文件：

   moc main.cpp -o main.moc
   

2. 在main.cpp的末尾添加：

   #include "main.moc"
   

3. 再正常编译main.cpp即可。

用qmake管理项目 #

如果用qmake，只需要在.pro文件里确保SOURCES += main.cpp，qmake会自动检测.cpp里的Q_OBJECT宏，触发MOC处理，生成对应的代码并参与编译。

你遇到的错误信息 #

/usr/bin/ld: /tmp/ccX909s9.ltrans1.ltrans.o: in function `MainWindow::~MainWindow()':
<artificial>:(.text+0x3): undefined reference to `vtable for MainWindow'
/usr/bin/ld: /tmp/ccX909s9.ltrans1.ltrans.o: in function `main':
<artificial>:(.text.startup+0x4a): undefined reference to `vtable for MainWindow'

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