Windows 版 Qt - 从源代码构建

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

步骤 1：获取源代码

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

如果您通过Qt Online Installer 安装源代码，这些文件将位于 Qt 安装目录中，例如 C:\Qt\6.12.0\Src。

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

步骤 2：安装构建所需组件并设置环境

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

构建工具

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

编译器

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

QDoc 依赖项

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

Qt GRPC 以及Qt Protobuf 的依赖项

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

• 在 Windows 搜索栏中搜索“VS Native Tools 命令提示符”。

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

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

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

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

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

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

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

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