如何告知GCC源码含Q_OBJECT？Qt编译AutoMoc警告排查

问题场景 #

编译C++/Qt目标文件时，收到如下AutoMoc警告：

"SRC:/modules/testobject.cpp"
includes the moc file "testobject.moc", but does not contain a Q_OBJECT, Q_GADGET, Q_NAMESPACE, Q_NAMESPACE_EXPORT or Q_GADGET_EXPORT macro.

但头文件已声明Q_OBJECT，且CMakeList.txt中已设置set(CMAKE_AUTOMOC ON)。

相关代码 #

头文件testobject.h：

#pragma once
#include <QObject>
class TestObject : public QObject {
  Q_OBJECT
public:
       TestObject();
  static TestObject *get() {
    static auto *handler = new TestObject;
    return handler;
  }
};

源文件testobject.cpp：

#include "testobject.h"
#include "testobject.moc"

TestObject::TestObject() {
}

问题原因 #

问题出在源文件testobject.cpp中手动包含了testobject.moc。CMake的AUTOMOC机制会自动扫描头文件中的Q_OBJECT宏，生成对应的moc文件并将其纳入编译流程。当AUTOMOC扫描你的cpp文件时，发现它包含了moc文件，但cpp本身没有Q_OBJECT这类宏，就会触发这条警告。

解决方法 #

• 移除cpp文件中的#include "testobject.moc"：AUTOMOC会自动处理moc文件的生成和链接，不需要手动包含。
• 确认CMake配置：确保set(CMAKE_AUTOMOC ON)已正确设置，并且项目通过target_include_directories或include_directories包含了头文件所在目录，保证AUTOMOC能正确扫描到头文件中的Q_OBJECT。

调整后，AUTOMOC会正常生成并编译testobject.moc，警告也会消失。

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