此页面描述了配置和构建的过程,针对 Qt for Windows . To download and install a pre-built Qt for Windows, follow the instructions on the Qt 快速入门 页面。
Qt sources can be installed in Qt Online Installer. Source packages are also available through Git , as archives in the Qt 帐户 (commercial users), and on download.qt.io (open-source users).
If you install the sources through Qt Online Installer, they will be available in the Qt installation directory, for instance
C:\Qt\6.7.2\Src
.
If you downloaded the source archive, extract it to a directory of your choice, for instance
C:\dev\Qt\src
.
注意: The path to the source directory must not contain any spaces or Windows-specific file system characters. The path should also be kept short. This prevents issues with too long file paths in the compilation phase.
To build Qt from sources you need a build environment with a supported compiler and various build tools.
工具 | 支持版本 | 描述 |
---|---|---|
CMake |
Version 3.16 and newer (3.17 and newer for
-debug-and-release
builds 3.21 and newer for
-static
builds).
|
Required for configuring the Qt build. Available in Qt Online Installer and on cmake.org . |
Ninja | - | Recommended tool for building Qt. Available in Qt Online Installer and on ninja-build.org . |
Python | Version 3 | Required build tool. Windows installers are available on python.org , or from the Microsoft Store . |
The executables
cmake.exe
,
ninja.exe
,和
python.exe
must be available in your build environment. Add the respective directory to your
PATH
环境变量。
The following compilers and configurations are supported in Qt 6.7:
操作系统 | 体系结构 | 编译器 | 注意事项 |
---|---|---|---|
Windows 10 (1809 或更高版本) |
x86_64
|
MSVC 2022, MSVC 2019, MinGW 11.2 | |
Windows 11 |
x86_64
|
MSVC 2022, MSVC 2019, MinGW 11.2 | |
ARM 中的 Windows |
arm64
|
MSVC 2019/2022 | 技术预览 |
注意: 仅支持将 ARM 中的 Windows 作为部署目标。应用程序必须自 x86-64 的 Windows 机器交叉编译并部署到目标。
QDoc uses Clang to parse C++ code. If you wish to build QDoc manually, refer to 为 QDoc 安装 Clang 对于特定构建要求。
Qt GRPC
and
Qt Protobuf
require installing
gRPC
and
Protobuf
packages. You can find the installation instructions for the packages in the
Example of installation for Windows using vcpkg
.
For MSVC, do one of the following:
"C:\Program Files\Microsoft Visual Studio\2022\Professional\VC\Auxiliary\Build\vcvarsall.bat" amd64
For MinGW: Add MinGW to
PATH
environment variable:
Set PATH=C:\qt\tools\mingw1120_64\bin;%PATH%
To configure your build, create a build directory and run the
configure.bat
script in this directory:
mkdir C:\dev\qt-build cd C:\dev\qt-build C:\dev\Qt\src\configure.bat
By default, Qt is configured for installation in the
C:\Qt\Qt-6.5.3
directory. This can be changed by using the
-prefix
option. See the list of
Qt 配置选项
to tweak further.
Then build the libraries and tools:
cmake --build . --parallel
Period after
--build
means current folder.
After building, you need to install the libraries and tools in the desired path (unless you enabled a developer build :
cmake --install .
After Qt is installed, you can start building applications with it.
If you work from the command line, consider adding the Qt tools to your
PATH
environment variable as follows:
set PATH=C:\Qt\Qt-6.5.3\bin;%PATH%
If you plan to use Qt from an IDE, you need to register the Qt version explicitly there. For Qt Creator, see Qt Creator: Adding Qt Versions .