如何查看Qt已安装的模块和库？

Question

如何查看当前Qt安装环境中已安装的模块和库？在开发过程中，经常需要确认是否安装了如 QtMultimedia、QtWebEngine 等特定模块。使用 `qmake -query` 只能查看基本路径信息，无法列出具体模块。是否有命令行工具或脚本方法（如通过 `qtconfig`、`pkg-config` 或 Qt 自带工具）可以准确获取已安装的 Qt 模块列表？特别是在多版本 Qt 共存（如通过在线安装器安装的多个 Qt 版本）时，如何针对某一特定 Qt 版本查询其可用模块？

Answer 1

一、引言：Qt模块管理的现实挑战

在现代Qt开发中，尤其是跨平台项目或大型系统集成场景下，开发者常常面临一个基础但关键的问题：如何准确获知当前Qt安装环境中已安装的模块（如QtMultimedia、QtWebEngine、QtBluetooth等）？

虽然qmake -query能提供诸如QT_INSTALL_LIBS、QT_HOST_DATA等路径信息，但它无法直接列出可用模块清单。这一限制在多版本Qt共存环境下尤为突出——例如使用Qt在线安装器（MaintenanceTool）安装了多个Qt版本（如5.15.2、6.4.3、6.7.0）并对应不同编译器（MinGW、MSVC、Clang）时。

本文将从浅入深，结合命令行工具、脚本方法和Qt内置机制，系统性地解析如何精准查询特定Qt版本下的模块列表，并为资深开发者提供可扩展的技术路径。

二、基础层面：通过文件系统与目录结构识别模块

最直观的方法是检查Qt安装路径下的库目录是否存在对应模块的动态/静态库文件。以Windows为例：

# 典型Qt安装路径
C:\Qt\5.15.2\mingw81_64\lib\libQt5Multimedia.a
C:\Qt\6.7.0\msvc2019_64\bin\Qt6WebEngine.dll

Linux/macOS上可通过以下命令快速扫描：

find /path/to/qt/version/lib -name "libQt*.*" | grep -i multimedia

该方式虽原始，但在无额外工具支持的环境中仍具实用性。其局限在于无法区分“已编译”与“可链接”状态，也无法判断模块是否被正确配置进构建系统。

三、中级方案：利用pkg-config查询模块元数据

在Linux系统中，若Qt安装时生成了.pc文件（位于lib/pkgconfig），则可使用pkg-config工具获取模块详情：

pkg-config --list-all | grep -i qt

输出示例：

qt5-webengine        Qt5WebEngine - WebEngine Library (Qt 5)
qt5-multimedia       Qt5Multimedia - Multimedia Library (Qt 5)
qt5-sql              Qt5Sql - SQL Database Support (Qt 5)

进一步查看某个模块的依赖项：

pkg-config --cflags --libs Qt5WebEngine

此方法依赖于pkg-config路径配置正确，可通过设置PKG_CONFIG_PATH指向目标Qt版本的lib/pkgconfig目录实现多版本隔离：

export PKG_CONFIG_PATH=/opt/Qt/6.4.3/gcc_64/lib/pkgconfig
pkg-config --list-all | grep -E 'Qt[0-9]*'

四、高级手段：使用Qt官方工具链精准定位模块

Qt自5.0起引入了更结构化的模块管理体系，推荐使用以下两种核心工具：

1. qmake查询模块变量
2. Qt配置头文件分析

首先，可通过qmake访问内部变量来间接推断模块存在性：

qmake -query QT_CONFIG

该命令返回一个长字符串，包含所有编译时启用的功能标志，如：

... webengine webengine-embedded-build multimedia audio-backend ...

注意：QT_CONFIG反映的是Qt库本身的构建配置，而非项目能否使用某模块。

功能标志	含义	关联模块
multimedia	启用了多媒体支持	QtMultimedia
webengine	WebEngine模块可用	QtWebEngine
opengl	OpenGL支持开启	QtOpenGL
sql-mysql	MySQL数据库驱动	QtSql
svg	SVG图像处理支持	QtSvg
xmlpatterns	XPath/XQuery引擎	QtXmlPatterns
positioning	地理定位功能	QtPositioning
nfc	NFC近场通信支持	QtNfc
bluetooth	蓝牙协议栈支持	QtBluetooth
serialbus	串行总线通信	QtSerialBus

五、深度剖析：解析qconfig-large.h或qconfig-small.h

每个Qt构建版本都会在其mkspecs目录下生成一个主配置头文件，通常位于：

$QTDIR/mkspecs/qconfig.pri
$QTDIR/include/QtCore/qconfig-large.h

这些文件定义了所有启用的模块宏，例如：

#define QT_FEATURE_webengine 1
#define QT_FEATURE_multimedia 1
#define QT_NO_NFC

通过脚本自动化提取这些宏，可构建完整的模块清单。示例Python脚本片段：

import re
with open('qconfig-large.h', 'r') as f:
    content = f.read()
features = re.findall(r'#define QT_FEATURE_(\w+)\s+1', content)
modules = [f"Qt{feat.capitalize()}" for feat in features if 'no_' not in feat.lower()]
print("Detected Modules:", modules)

六、工程实践：针对多版本Qt环境的模块查询策略

当系统中存在多个Qt版本（如通过~/Qt/5.15.2/gcc_64和~/Qt/6.7.0/clang_64安装）时，必须明确指定目标Qt的qmake路径：

/home/user/Qt/6.7.0/clang_64/bin/qmake -query QT_INSTALL_HEADERS
/home/user/Qt/5.15.2/gcc_64/bin/qmake -query QT_CONFIG

建议封装为Shell函数：

qt_modules() {
    local qmake_path=$1
    if [ -x "$qmake_path" ]; then
        echo "=== Modules for $($qmake_path -query QT_VERSION) ==="
        $qmake_path -query QT_CONFIG | tr ' ' '\n' | grep -E '(webengine|multimedia|bluetooth|positioning|serial.*)'
    else
        echo "qmake not found at $qmake_path"
    fi
}
# 使用示例
qt_modules ~/Qt/6.4.3/gcc_64/bin/qmake

七、可视化辅助：使用Qt Maintenance Tool验证安装组件

Qt在线安装器自带的MaintenanceTool提供了图形化视角：

• 启动MaintenanceTool
• 进入“Settings” → “Repositories”确认源地址
• 选择“Add or remove components”
• 展开具体Qt版本节点，查看勾选状态的模块（如Qt WebEngine、Qt Multimedia）

这是唯一能100%确认“用户意图安装”的模块集合的方式，尤其适用于CI/CD环境初始化前的审计。

八、流程整合：模块检测自动化决策树

以下是综合判断流程的Mermaid图示：

graph TD
    A[开始] --> B{指定Qt版本?}
    B -- 是 --> C[定位对应qmake路径]
    B -- 否 --> D[列出所有已注册qmake]
    C --> E[执行qmake -query QT_CONFIG]
    D --> F[遍历各版本执行E]
    E --> G[解析功能标志]
    F --> G
    G --> H[映射到Qt模块名]
    H --> I[输出模块列表]
    I --> J[结束]
    

九、扩展思考：CMake与Qt6模块发现机制的变化

随着Qt6全面转向CMake作为首选构建系统，模块查询方式也发生演进。在CMake项目中，可通过find_package(Qt6 REQUIRED COMPONENTS ...)尝试加载模块，并结合message(STATUS "Found: ${Qt6_FOUND}")进行探测。

更进一步，使用cmake --find-package模式（实验性）或编写轻量级CMake脚本批量测试模块可用性：

# test_module.cmake
include(FindQt6)
find_package(Qt6 COMPONENTS ${MODULE} QUIET)
if(Qt6_${MODULE}_FOUND)
    message(STATUS "✅ ${MODULE} is available")
else()
    message(WARNING "❌ ${MODULE} not found")
endif()

这为自动化构建环境提供了新的检测维度。