将Qt主项目改为Subdirs模板后编译失败，QObject类识别异常

问题本质 #

你遇到的核心问题是对Subdirs模板的定位错误：Subdirs类型的项目是纯项目容器，它本身不参与代码编译，仅用于管理多个子项目的构建流程。当你给主项目添加TEMPLATE = subdirs后，qmake会自动忽略SOURCES、HEADERS、QT模块依赖这些编译相关配置，导致编译器找不到Qt核心类（比如QObject）的定义，最终标记为"未知类型"。

正确的项目结构调整步骤 #

1. 拆分项目为「根容器」+「应用子项目」+「测试子项目」

• 新建根Subdirs项目：创建一个空的根项目（比如命名为RootProject），它的.pro文件只保留Subdirs核心配置，不能包含任何编译相关内容：

TEMPLATE = subdirs
# 列出所有子项目，顺序决定构建优先级
SUBDIRS += \
    MainApp \
    AutoTests

• 迁移原应用代码到子项目：把你当前主项目里的所有源代码、头文件、QT依赖、资源文件等，全部迁移到一个新的App类型子项目（比如MainApp）中，这个子项目的.pro保留你原来的配置（去掉TEMPLATE = subdirs）：

QT += quick core gui network
greaterThan(QT_MAJOR_VERSION, 4): QT += widgets
CONFIG += c++11 qml_debug declarative_debug console

win32 {
    LIBS += -lws2_32
}

# 保留原有的源文件、头文件、资源配置
SOURCES += \
    applicationservice.cpp \
    blinkingtimer.cpp \
    shapes/genericshape.cpp \
    ... # 其他所有源文件
HEADERS += \
    applicationservice.h \
    blinkingtimer.h \
    shapes/genericshape.h \
    ... # 其他所有头文件
RESOURCES += qml.qrc

# 保留原有的部署、QML导入路径配置
QML_IMPORT_PATH =
QML_DESIGNER_IMPORT_PATH =
qnx: target.path = /tmp/$${TARGET}/bin
else: unix:!android: target.path = /opt/$${TARGET}/bin
!isEmpty(target.path): INSTALLS += target

2. 添加自动化测试子项目

在根项目中新增一个Auto Test Project（Qt Creator自带模板），它会自动配置Qt Test框架，并且自动被根项目的SUBDIRS包含。如果测试项目需要依赖主应用的代码，可以在根项目的.pro中添加依赖声明：

SUBDIRS += MainApp AutoTests
# 确保先构建主应用，再构建测试项目
AutoTests.depends = MainApp

3. 修复Qt Creator代码模型识别

完成结构调整后：

• 关闭Qt Creator，删除项目目录下的.user文件和所有构建文件夹
• 重新打开根Subdirs项目，Qt Creator会重新解析所有子项目，QObject类的识别问题会自动消失

关键注意事项 #

• Subdirs类型项目仅用于管理子项目，绝对不能添加SOURCES、HEADERS、QT模块依赖这类编译相关配置
• 子项目间的依赖必须通过根项目的depends字段声明，确保构建顺序正确

内容的提问来源于stack exchange，提问作者Деян Цонев