本页内容

Linux 版 Qt - 系统要求

平台插件依赖项

在 Linux 上,使用xcbQPA(Qt 平台抽象)平台插件。它提供了 Qt GUI 以及 Qt Widgets 在 X11 环境下运行所需的基本功能。其库依赖关系如下表所示。若要从源代码构建 Qt,您还需要为您的系统安装这些库的开发包。

名称库备注配置选项最低工作版本
XRenderlibXrenderX 渲染扩展;用于抗锯齿和透明光标支持-xrender 或自动检测0.9.0
xcb-renderlibxcb-render渲染扩展的 X C 绑定自动检测1.11
xcb-render-utillibxcb-render-util用于 Render 扩展的 XCB 实用程序库自动检测0.3.9
xcb-shapelibxcb-shapeShape 扩展的 XC 绑定自动检测1.11
xcb-randrlibxcb-randr用于“调整大小和旋转”扩展的 X C 绑定自动检测1.11
xcb-xfixeslibxcb-xfixes用于“修复”扩展的 X C 绑定自动检测1.11
xcb-xkblibxcb-xkbXKeyboard 扩展的 X C 绑定自动检测1.11
xcb-synclibxcb-sync同步扩展的 X C 绑定自动检测1.11
xcb-shmlibxcb-shm共享内存扩展的 X C 绑定自动检测1.11
xcb-icccmlibxcb-icccmICCCM 协议的 X C 绑定自动检测0.3.9
xcb-keysymslibxcb-keysyms用于 XCB 键码转换的实用程序库自动检测0.3.9
xcb-imagelibxcb-image用于 XImage 和 XShmImage 的 XCB 实用程序库,用于支持QBackingStore 和光标自动检测0.3.9
xcb-utillibxcb-util用于 atom、aux 和 event 的 XCB 实用程序库自动检测0.3.9
xcb-cursor0libxcb-cursor0用于 XCB 的光标实用程序库自动检测0.1.1
xkbcommonlibxkbcommon键盘映射处理-xkbcommon 或自动检测0.9.0
xkbcommon-x11libxkbcommon-x11键位映射处理自动检测0.9.0
Fontconfiglibfontconfig字体自定义和配置-fontconfig 或自动检测2.6
FreeTypelibfreetype字体引擎2.3.0
XextlibXextX 扩展6.4.3
X11libX11X11 客户端库6.2.1
xcblibxcbX C 绑定库1.11
X11-xcblibX11-xcbXlib/XCB 接口库1.3.2
SMlibSMX 会话管理-sm 或自动检测6.0.4
ICElibICE客户端间交换-sm 或自动检测6.3.5
gliblibglib-2.0通用事件循环处理-glib 或自动检测2.8.3
pthreadlibpthread多线程2.3.5

上述库的开发软件包包含头文件,这些头文件在从源代码构建 Qt 时会被用到。不同 Linux 发行版的软件包名称可能有所不同,而且某些发行版在其软件包管理系统的默认配置中可能并未包含所有软件包。

例如,您可以在基于 Debian 的 GNU/Linux 系统上运行以下命令来安装推荐的软件包:

apt install \
    libfontconfig1-dev \
    libfreetype-dev \
    libgtk-3-dev \
    libx11-dev \
    libx11-xcb-dev \
    libxcb-cursor-dev \
    libxcb-glx0-dev \
    libxcb-icccm4-dev \
    libxcb-image0-dev \
    libxcb-keysyms1-dev \
    libxcb-randr0-dev \
    libxcb-render-util0-dev \
    libxcb-shape0-dev \
    libxcb-shm0-dev \
    libxcb-sync-dev \
    libxcb-util-dev \
    libxcb-xfixes0-dev \
    libxcb-xkb-dev \
    libxcb1-dev \
    libxext-dev \
    libxfixes-dev \
    libxi-dev \
    libxkbcommon-dev \
    libxkbcommon-x11-dev \
    libxrender-dev

其中部分软件包依赖于列表中的其他软件包,因此安装其中一个可能会导致其他软件包被自动安装。其他发行版可能提供名称相似的系统软件包。

Qt 并未维护涵盖所有发行版的全面软件包列表。某些发行版(例如 Red Hat™ 及其衍生版本,可能需要额外的软件源来获取某些软件包(例如 RHEL 所需的 EPEL)。请查阅您所用发行版的文档以获取具体的软件包名称。RHEL 用户可联系Red Hat 支持团队获取详细信息。

辅助功能依赖项

Qt 的无障碍功能实现使用辅助技术服务提供商接口(AT-SPI)。除 DBUS 外,还必须安装开发包libatspi2.0-dev 。

OpenGL 依赖项

配置程序会尝试自动检测 OpenGL ES 2.0 或更高版本,或常规桌面版 OpenGL。您可以通过使用-no-opengl 选项来禁用 OpenGL 支持。

注意: Qt OpenGL 模块 (其中包含以QGL 开头的类)已被弃用,建议改用 Qt GUI 模块(其中包含以QOpenGL 开头的类)。

QDoc 的依赖项

QDoc使用 Clang 来解析 C++ 代码。如果您希望手动构建 QDoc,请参阅《为 QDoc 安装 Clang》以了解具体的构建要求。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.