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.11.0\Src.
如果您下载了源代码压缩包，请将其解压到您选择的目录，例如C:\dev\Qt\src 。
注意： 指向源代码目录的路径不得包含任何空格或 Windows 特定的文件系统字符。路径也应保持简短。这样可以避免在编译阶段出现文件路径过长的问题。
步骤 2：安装构建要求并设置环境
要从源代码构建 Qt，你需要一个包含支持的编译器和各种构建工具的构建环境。
构建工具
工具支持版本支持版本
CMake3.22 及更新版本。配置 Qt 联编所需。可从Qt Online Installer 和cmake.org 获取。
忍者-推荐用于构建 Qt 的工具。见Qt Online Installer 和ninja-build.org。
Python版本 3必需的构建工具。Windows 安装程序可从python.org 或Microsoft Store 获取。
可执行文件cmake.exe 、ninja.exe 和python.exe 必须在构建环境中可用。将相应目录添加到PATH 环境变量中。
编译器
Qt 6.11 支持以下编译器和配置：
操作系统架构编译器注释
Windows 10（1809 或更高版本）x86_64MSVC 2022、Mingw-w64 13.1
视窗 11x86_64MSVC 2022、Mingw-w64 13.1
ARM 上的 WindowsARM64MSVC 2022
注： 目前 Qt 不支持 ARM 设备上的 Windows ARM64EC。
注： 对于 MSVC 2022，必须在 Visual Studio 安装程序中选择 10.0.17763 或更高版本的 Windows SDK。
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
# or
ninja
--build 后的句点表示当前文件夹。
构建完成后，您需要将库和工具安装到所需路径（除非您启用了开发者构建）：
cmake --install .
# or
ninja install
注意： 对于 CMake 版本 < 4.0。 cmake --install . 命令只安装发布版本的库和工具，即使你同时编译了调试库和发布库。要同时安装调试版和发布版库，请使用ninja install 。也可以同时运行cmake --install . --config Debug 和cmake --install . --config Release 命令。
步骤 4：构建应用程序
安装完 Qt 后，就可以开始用它构建应用程序了。
如果您使用命令行工作，可考虑将 Qt 工具添加到PATH 环境变量中，如下所示：
set PATH=C:\Qt\Qt-major.minor.patch\bin;%PATH%
如果您计划在集成开发环境中使用 Qt，则需要在其中明确注册 Qt 版本。有关Qt Creator ，请参阅Qt Creator: 添加 Qt 版本。
