C++|Qt-Q_OBJECT宏及控件提升导致的类重定义问题

前言 在项目中遇到了这么个奇怪的问题,类加上Q_OBJECT宏之后,出现类重定义报错。具体描述如下:
SelectConvertDialog是一个ui类,.ui文件中通过控件提升的方式提升QTableWidget为SelectConvertTable,而SelectConvertTable类头文件中也加上了Q_OBJECT宏,编译后报错:

【C++|Qt-Q_OBJECT宏及控件提升导致的类重定义问题】严重性 代码 说明 项目 文件 行 禁止显示状态
错误 C2011 “SelectConvertTable”:“class”类型重定义 (编译源文件 D:\project\xxxxx\mocs_compilation.cpp)
分析 重定义意味着出现了两次class SelectConvertTable声明,但是我们显然只声明了一次,那么唯一的可能,就是在头文件include的时候,将这个头文件include了两次
报错的文件是mocs_compilation,其中出现了两行include
#include #include

我们知道moc_开头的文件是由moc从.h文件自动帮我们生成的,查看moc_SelectConvertTable.cpp代码,首行
#include "UIModule/SelectConvertTable.h"

moc_SelectConvertDialog.cpp首行:
#include "UIModule/SelectConvertDialog.h"

而SelectConvertDialog是一个UI界面类,具有以下include语句
#include "ui_SelectConvertDialog.h"

该文件由uic从.ui文件生成,因为我们将ui文件中的QTableWidget提升为SelectConvertTable,所以ui_SelectConvertDialog.h中会自动include头文件SelectConvertTable.h,代码如下:
#include "selectconverttable.h"

至此真相大白,由于qt的uic和moc系统帮助我们生成了一些代码,导致出现重定义的问题。那要怎么解决呢?很简单,使用#ifndef防止重复include就可以了
#ifndef SELECECONVERTTABLE_H #define SELECECONVERTTABLE_H //原SelectConvertTable.h文件内容不变 ... #endif // SELECECONVERTTABLE_H

建议 头文件应都加上#ifndef语句,防止重复include同一个头文件

    推荐阅读