Qt for Windows - 从源代码构建

本页介绍配置和构建Qt for Windows 的过程。要下载并安装预构建的 Windows 版 Qt，请按照 "Qt 入门"页面上的说明进行操作。

步骤 1：获取源代码

Qt 源代码可安装在Qt Online Installer 中。源码包也可通过 Git、Qt 账户中的存档（商业用户）和download.qt.io上的存档（开源用户）获取。

如果通过Qt Online Installer 安装源代码，它们将出现在 Qt 安装目录中，例如C:\Qt\6.9.0\Src 。

如果您下载了源代码压缩包，请将其解压到您选择的目录，例如C:\dev\Qt\src 。

步骤 2：安装构建要求并设置环境

要从源代码构建 Qt，你需要一个包含支持的编译器和各种构建工具的构建环境。

构建工具

可执行文件cmake.exe 、ninja.exe 和python.exe 必须在构建环境中可用。将相应目录添加到PATH 环境变量中。

编译器

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

QDoc 依赖项

QDoc使用 Clang 来解析 C++ 代码。如果您希望手动构建 QDoc，请参阅 "Installing Clang for QDoc"（为 QDoc 安装 Clang）了解具体的构建要求。

Qt GRPC 和 依赖项Qt Protobuf

Qt GRPC和 Qt Protobuf需要安装gRPC 和Protobuf 软件包。您可以在Windows 使用 vcpkg 安装示例中找到软件包的安装说明。

设置环境

对于 MSVC，请执行以下操作之一：

• 运行 vcvarsall.bat：

  "C:\Program Files\Microsoft Visual Studio\2022\Professional\VC\Auxiliary\Build\vcvarsall.bat" amd64
• 在 Windows 搜索栏中搜索 VS Native Tools 命令提示符。

对于 Mingw-w64：在PATH 环境变量中添加 Mingw-w64：

Set PATH=C:\qt\tools\mingw1120_64\bin;%PATH%

步骤 3：构建 Qt 库和工具

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

mkdir C:\dev\qt-build
cd C:\dev\qt-build
C:\dev\Qt\src\configure.bat

默认情况下，Qt 被配置安装在C:\Qt\Qt-major.minor.patch 目录中，其中 major.minor.patch 三元组代表正在构建的 Qt 版本。这可以通过-prefix 选项进行更改。如需进一步调整，请参阅Qt 配置选项列表。

然后构建库和工具：

cmake --build . --parallel

--build 后的句点表示当前文件夹。

构建完成后，您需要将库和工具安装到所需路径（除非您启用了开发人员构建）：

cmake --install .

步骤 4：构建应用程序

Qt 安装完成后，就可以开始构建应用程序了。

如果你使用命令行工作，可以考虑将 Qt 工具添加到PATH 环境变量中，方法如下：

set PATH=C:\Qt\Qt-major.minor.patch\bin;%PATH%

如果您计划在集成开发环境中使用 Qt，则需要在其中明确注册 Qt 版本。有关Qt Creator ，请参阅Qt Creator: 添加 Qt 版本。