QML集成子文件夹下C++类时头文件找不到的qmake配置问题

你遇到的问题核心是开启CONFIG += qmltypes后，moc生成application.metatypes.json时的头文件路径匹配规则完全依赖INCLUDEPATH配置，你当前的INCLUDEPATH配置错误，导致moc只能匹配到头文件名，无法拿到正确的子目录相对路径，所以生成的json文件路径错误。

解决步骤 #

1. 修正INCLUDEPATH配置
   你当前写的INCLUDEPATH += $$PWD/..是把项目根目录的上级目录加入头文件搜索路径，完全没有覆盖项目自身的目录，根据你代码中引用头文件的写法二选一即可：

• 如果你代码中引用头文件的写法是#include "businessLogic/loginstate.h"，只需要把项目根目录加入搜索路径：

INCLUDEPATH += $$PWD

• 如果你代码中引用头文件的写法是#include "loginstate.h"，需要额外把业务代码子目录加入搜索路径：

INCLUDEPATH += $$PWD $$PWD/businessLogic

如果修改后仍有路径识别问题，可以额外加一行配置强制moc搜索项目根目录：

MOC_INCLUDEPATH += $$PWD

2. 清理缓存重新构建
   修改完.pro文件后，必须完全删除旧的构建目录，执行「重新qmake」+「全量构建」，避免旧的application.metatypes.json缓存影响构建结果。

补充说明 #

Qt Creator的语法解析默认会扫描项目内所有子目录作为头文件搜索路径，和qmake构建时的规则完全独立，所以会出现IDE无报错但构建失败的情况，属于正常现象。

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