QMake中equals条件下SUBDIRS仅构建指定子目录但项目视图显示全部？

问题场景 #

使用QMake的TEMPLATE = subdirs模式时，通过equals条件根据TEST_VALUE动态添加SUBDIRS，实际构建逻辑正常（比如TEST_VALUE=1时仅构建sub1），但Qt Creator左侧项目视图仍会显示所有子目录。

你的配置代码：

TEMPLATE = subdirs
TEST_VALUE = 1

equals(TEST_VALUE,1) {
message($$TEST_VALUE)
SUBDIRS += \
    sub1
}

equals(TEST_VALUE,2) {
message($$TEST_VALUE)
SUBDIRS += \
    sub2
}

equals(TEST_VALUE,3) {
message($$TEST_VALUE)
    SUBDIRS += \
        sub3
}

原因分析 #

Qt Creator的项目视图是基于qmake项目文件的静态扫描解析，而非执行qmake脚本后的动态结果。IDE会自动检测项目目录下所有包含.pro文件的子目录，无论这些子目录是否被qmake的条件逻辑排除，都会显示在视图中——这是IDE为了完整展示项目结构的设计，和实际构建流程无关。

解决办法 #

使用Qt Creator识别的特殊变量IDE_SUBDIRS，它可以指定IDE项目视图中显示的子目录，覆盖静态扫描的结果。修改后的配置如下：

TEMPLATE = subdirs
TEST_VALUE = 1

equals(TEST_VALUE,1) {
    message($$TEST_VALUE)
    SUBDIRS += sub1
    IDE_SUBDIRS = sub1
}

equals(TEST_VALUE,2) {
    message($$TEST_VALUE)
    SUBDIRS += sub2
    IDE_SUBDIRS = sub2
}

equals(TEST_VALUE,3) {
    message($$TEST_VALUE)
    SUBDIRS += sub3
    IDE_SUBDIRS = sub3
}

修改后重新运行qmake，Qt Creator的项目视图就会只显示当前TEST_VALUE对应的子目录，同时实际构建逻辑保持不变。

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