Qt精简构建CMAKE报错原因及缺失模块排查方法咨询

环境与构建背景 #

Win11 + Visual Studio 2022环境下，构建仅包含Core、Widgets、Network模块的Qt6静态发布版（QTbuild1），构建命令如下：

cd d:\qt6_lib_release_build
d:\qt6\qt5\configure.bat -release -static -skip qtwebengine -skip qtwebview -skip qtsensors -prefix "d:\qt6\lib_release_install"
cmake --build . --parallel --target qtbase

报错信息 #

使用该构建版本编译CMake项目时触发错误：

D:/qt6/lib_release_install/lib/cmake/Qt6Gui/Qt6QTgaPluginConfig.cmake:58 (include):
include could not find requested file:
D:/qt6/lib_release_install/lib/cmake/Qt6Gui/Qt6QTgaPluginTargets.cmake

项目依赖 #

CMake项目仅关联以下Qt模块：

find_package(Qt6 COMPONENTS Widgets REQUIRED)
find_package(Qt6 COMPONENTS Network REQUIRED)
find_package(Qt6 COMPONENTS Core REQUIRED)

补充信息 #

• 缺失的Qt6QTgaPluginTargets.cmake确实不存在，但Qt6QTgaPluginConfig.cmake文件存在
• 此前使用全模块（仅跳过部分模块）的Debug版Qt构建（QTbuild2，命令cmake --build . --parallel）编译该项目无错误

报错原因 #

1. 构建范围不完整：仅构建qtbase目标无法覆盖所有依赖模块，QTgaPlugin属于qtimageformats模块，不在qtbase的构建范围内。静态构建模式下，Qt6的CMake配置会自动关联图像格式插件（QtGui模块依赖这些插件处理图像），未构建qtimageformats就会导致目标文件缺失。
2. 静态构建的插件关联特性：静态Qt的CMake配置默认会尝试引入所有图像插件的目标，而Debug全模块构建时自动包含了qtimageformats，因此未触发错误。

解决方法 #

1. 补充构建缺失模块 #

在已有的QTbuild1构建目录中，执行以下命令构建qtimageformats并安装：

cmake --build . --parallel --target qtimageformats
cmake --install . --component Qt6 --prefix "d:\qt6\lib_release_install"

2. 确保构建完整性（避免后续遗漏） #

如果后续出现其他插件缺失报错（如QJpegPlugin），可以：

• 查看构建目录下的CMakeCache.txt，搜索QT_BUILD_MODULES或QT_SKIP_MODULES，确认未被构建的必要模块
• 或者直接构建所有未被-skip排除的模块，替换原构建命令：

cmake --build . --parallel --target all

3. 按需禁用不必要插件（可选） #

如果不需要TGA图像格式支持，可在CMake项目中添加配置禁用该插件：

set(QT_DISABLE_PLUGINS "qtga")

也可以仅启用需要的图像插件：

set(QT_ENABLE_PLUGINS "qjpeg") # 按需添加其他插件，如qpng等

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