Qt for Windows - 从源代码构建

本页描述了配置和构建 Qt for Windows 的过程。要下载和安装预构建的 Qt for Windows，请按照Qt 入门指南页面上的说明操作。

步骤 1：获取源代码

Qt 源代码可以通过 Qt 在线安装程序进行安装。源代码包也通过 Git 可用，作为 Qt 账户（商业用户）中的存档，以及在 download.qt.io（开源用户）上。

如果您通过 Qt 在线安装程序安装源代码，它们将可用在 Qt 安装目录中，例如 C:\Qt\6.7.2\Src。

如果您已下载源代码存档，将其提取到您选择的目录中，例如 C:\dev\Qt\src。

注意： 源代码目录的路径中不得包含任何空格或 Windows 特定的文件系统字符。路径也应保持较短。这可以防止在编译阶段出现过长的文件路径问题。

要从源代码构建 Qt，您需要具有支持编译器和各种构建工具的构建环境。

工具	支持版本	描述
CMake	版本 3.16 及以上（3.17 及以上用于 -debug-and-release 构建，3.21 及以上用于 -static 构建）。	用于配置 Qt 构建。在 Qt 在线安装程序和 cmake.org 上可用。
Ninja	-	构建 Qt 的推荐工具。在 Qt 在线安装程序和 ninja-build.org 上可用。
Python	版本 3	所需的构建工具。Windows 安装程序在 python.org 上有提供，或从 Microsoft Store 获取。

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

Qt 6.7 支持以下编译器和配置

注意： Windows on ARM 仅作为部署目标受支持。应用程序必须从 x86_64 Windows 机器交叉编译并部署到目标。

QDoc 使用 Clang 解析 C++ 代码。如果您想手动构建 QDoc，请参阅为 QDoc 安装 Clang 的指南，了解具体的构建要求。

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

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

运行 vcvarsall.bat

"C:\Program Files\Microsoft Visual Studio\2022\Professional\VC\Auxiliary\Build\vcvarsall.bat" amd64

对于 MinGW：将 MinGW 添加到 PATH 环境变量

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

要配置您的构建，创建一个构建目录，然后在该目录中运行 configure.bat 脚本。

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

默认情况下，Qt 配置为安装到 C:\Qt\Qt-6.5.3 目录。这可以通过使用 -prefix 选项来更改。有关更多配置，请参阅 Qt 配置选项。

然后构建库和工具

cmake --build . --parallel

在 --build 后面放置的句点表示当前文件夹。

构建完成后，您需要在指定的路径中安装库和工具（除非您启用了开发者构建）。

cmake --install .

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

如果您在命令行中工作，请考虑将 Qt 工具添加到您的 PATH 环境变量中，如下所示：

set PATH=C:\Qt\Qt-6.5.3\bin;%PATH%

如果您计划从 IDE 使用 Qt，您需要在该 IDE 中显式注册 Qt 版本。对于 Qt Creator，请参阅 Qt Creator：添加 Qt 版本。