Qmake生成依赖引发ODR违反，如何自动添加全量头文件依赖？

问题背景 #

在大型代码库中，Qmake的依赖处理逻辑会导致与非Qt项目共享头文件时出现效率损失与未定义行为：当间接依赖的头文件变更时，依赖它的源文件不会自动重新编译，最终引发ODR（One Definition Rule）违反，表现为堆损坏、内存写入错误等问题。

极简项目结构 #

非Qt共享头文件（无QObject，moc忽略） #

// Aclass.h:
struct A {
   int first;
   // float new_field; // 仓库拉取的可能变更
   double old_field;
};

中间头文件（可能被moc处理） #

// Bclass.h:
#include "Aclass.h"
struct B : A {
   // 可能因外部原因变更的定义
};

Qt业务类头文件 #

// app.h
#include "Bclass.h"
#include <QApplication> 

class QApp : public QApplication
{
   Q_OBJECT
public:
   QApp();
   void foo();

   B b;
};

业务类实现 #

// app.cpp
#include "app.h"
QApp::QApp(int & argc, char ** argv ) : QApplication(argc, argv) {}
void QApp::foo() { b.old_field = 0.0; } 

入口代码 #

#include "app.h"
int main(int argc, char** argv)  {
     QApp app(argc, argv);
     app.foo();
     // app.b.new_field = 0.0f; // 仓库拉取的更新
}

所有.h文件已加入.pro的HEADERS变量。

问题现象 #

项目编译完成后，若从仓库拉取Aclass.h和main.cpp的更新（比如给struct A新增字段），app.cpp不会被自动重新编译。旧的app.o与新的main.o链接后，会触发ODR违反：main.o使用struct A和QApp的新定义，而app.o仍保留旧定义，最终引发未定义行为。

根源在于Qmake生成的Makefile中，.o文件仅直接依赖自身.cpp、对应的.h以及moc处理的文件，不会递归追踪间接依赖的头文件（如Aclass.h）。当前团队的临时解决方案是全量清理构建目录后重新编译，但1GB级代码库编译耗时数小时，效率极低。

解决方案 #

无需手动编写脚本修改每个.o的依赖，可通过以下Qmake内置机制解决：

1. 启用递归依赖扫描 #

在.pro文件中添加：

DEPENDPATH += $$PWD

DEPENDPATH指定Qmake扫描依赖的目录，设置为当前目录后，Qmake会递归解析所有头文件的包含关系，将间接依赖的头文件（如Aclass.h）加入对应.o的依赖列表。

2. 强制编译器生成完整依赖树 #

若上述方法不生效，可通过编译器参数生成依赖文件，让Qmake自动读取：

QMAKE_CXXFLAGS += -MMD -MP

-MMD会让编译器生成.d文件，记录所有直接和间接的头文件依赖；-MP会为每个依赖头文件生成空目标，避免头文件被删除时Makefile报错。Qmake会自动识别这些.d文件并更新依赖关系。

3. 确认HEADERS配置完整性 #

确保所有相关头文件都已加入HEADERS：

HEADERS += Aclass.h Bclass.h app.h

Qmake会优先处理HEADERS中的文件，确保它们被纳入依赖扫描范围。

验证方法 #

修改Aclass.h后执行make，观察app.cpp是否被自动重新编译。若app.o的依赖列表中出现Aclass.h，则说明配置生效。

内容的提问来源于stack exchange，提问作者Swift - Friday Pie