Linux 版 Qt - 从源代码编译

本页面介绍如何在 Linux 上从源代码配置和构建Qt。请注意，通常通过安装预编译的 Qt 库和工具即可。 Qt Online Installer。许多 Linux 发行版还通过其包管理器提供 Qt 软件包。不过，如果您希望进一步自定义 Qt，或者所使用的发行版没有提供（正确版本的）Qt 二进制软件包，则应从源代码构建 Qt。

发行版打包人员可在打包建议中找到有关如何打包 Qt 的更多信息。

步骤 1：获取源代码

Qt 源代码可安装在Qt Online Installer 。源代码包还可通过 Git 获取，或以存档形式从Qt 账户（商业用户）和download.qt.io（开源用户）下载。

如果您通过Qt Online Installer 安装源代码，它们将位于 Qt 安装目录中，例如$HOME/Qt/6.12.0/Src 。

如果您下载了单个源代码压缩包，请将其解压到您选择的目录中：

cd /tmp
tar xf ~/Downloads/qt-everywhere-src-6.12.0.tar.xz

步骤 2：安装构建所需组件

构建 Qt 需要一个包含工具、编译器和开发软件包的构建环境。

构建工具

编译器与开发套件

Qt 6.12 支持以下编译器和配置：

其他编译器和配置方案或许可行，但尚未经过积极测试。

Qt 还依赖于各种库和开发包的可用性，这些通常由相应系统的包管理器安装。详情请参阅《Qt for Linux - 系统要求》。

步骤 3：构建 Qt 库和工具

要配置构建，请创建一个构建目录，并在该目录中运行./configure 脚本：

mkdir -p ~/dev/qt-build
cd ~/dev/qt-build
/tmp/qt-everywhere-src-6.12.0/configure

默认情况下，Qt 配置为安装在/usr/local/Qt-6.12.0 目录中。可通过使用-prefix 选项来更改此设置。请参阅配置选项列表以进行进一步调整。

configure 是否已成功运行？如果是，请继续构建库和工具：

cmake --build . --parallel

构建完成后，您需要将库和工具安装到适当的位置（除非您启用了开发者构建）：

cmake --install .

请注意，此操作可能需要 root 权限。

步骤 4：构建您的应用程序

安装 Qt 后，您就可以开始使用它构建应用程序了。

如果您使用命令行进行操作，建议将 Qt 工具添加到默认的 `PATH` 文件中。操作步骤如下：

在.profile 文件中（如果您的shell是bash、ksh、zsh或sh），添加以下几行：

PATH=/usr/local/Qt-6.12.0/bin:$PATH
export PATH

在.login 中（如果您的shell是csh或tcsh），请添加以下这一行：

setenv PATH /usr/local/Qt-6.12.0/bin:$PATH

如果您计划通过 IDE 构建应用程序，则需要在此处显式注册 Qt 版本：

• 关于Qt Creator ，请参阅Qt Creator ：添加 Qt 版本。
• 对于Qt Extension for Visual Studio Code ，请参阅Qt Extension for Visual Studio Code ：注册 Qt 安装。