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

2022-06-15 ui qt c++

前言在项目中遇到了这么个奇怪的问题，类加上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同一个头文件

推荐阅读

上一篇：C++学习|C++从文件中提取英文单词

下一篇：QT|Qt状态机的使用