此頁麵描述瞭配置和構建的過程，針對 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 the Qt Online Installer. Source packages are also available as Git repositories , as archives in the Qt 帳戶 (commercial users), and on download.qt.io (open-source users).
If you install the sources through the Qt Online Installer, they will be available in the Qt installation directory, for instance
C:\Qt\6.5.1\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 avoids 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 available:
| 工具 | 支持版本 | 描述 |
|---|---|---|
| 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 the Qt Online Installer and on cmake.org . |
| Ninja | - | Recommended tool for building Qt. Available in the 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. You achieve this by adding the respective directory to your
PATH
環境變量。
The following compilers and configurations are supported in Qt 6.5:
| 操作係統 | 體係結構 | 編譯器 | |
|---|---|---|---|
| Windows 10 (1809 or later) |
x86_64
|
MSVC 2022, MSVC 2019, MinGW 11.2 | |
| Windows 11 |
x86_64
|
MSVC 2022, MSVC 2019, MinGW 11.2 | |
| Windows on ARM |
arm64
|
MSVC 2019/2022 | 技術預覽 |
注意： Windows on ARM is only supported as a deployment target. Applications have to be cross-compiled from an x86-64 Windows machine and deployed to target.
QDoc uses Clang to parse C++ code. If you wish to build QDoc manually, refer to 為 QDoc 安裝 Clang 對於特定構建要求。
我們推薦創建桌麵鏈接打開命令提示，采用的環境設置類似
Command Prompt
菜單條目提供通過 Visual Studio。這是通過創建應用程序鏈接完成，傳遞
.cmd
文件設置環境和命令行選項
/k
(保持打開) 給
cmd.exe
.
假定文件名為
qt6vars.cmd
和 Qt 文件夾名為
C:\Qt\6.5.1\Src
:
REM Set up Microsoft Visual Studio 2019, where <arch> is amd64, x86, etc. CALL "C:\Program Files (x86)\Microsoft Visual Studio\2019\Professional\VC\Auxiliary\Build\vcvarsall.bat" <arch> SET _ROOT=C:\Qt\6.5.1\Src SET PATH=%_ROOT%;%PATH% SET _ROOT=
然後，可以創建桌麵鏈接通過指定命令
%SystemRoot%\system32\cmd.exe /E:ON /V:ON /k C:\Qt\qt6vars.cmd
as application.
Depending on your individual setup, you might also need to make the installation directories of CMake, Ninja, and Python part of the
SET %PATH%
line above.
注意：
Setups for MinGW are similar; they differ only in that the
bin
folder of the installation should be added to the path instead of calling the Visual Studio setup script. For MinGW, please make sure that no
sh.exe
可以在路徑中被找到，因為它影響
mingw32-make
.
To configure the Qt library for your machine type, run the
configure.bat
script in the source directory. Alternatively, if you have already completed Step 3, you may double-click on the desktop link you created, and type
configure
and start configuring the Qt library in your selected directory.
By default, Qt is configured for installation in the
C:\Program Files\Qt
directory, but this can be changed by using the
-prefix
選項。
The 配置選項 page contains more information about the configure options. See Qt for Windows - Graphics Acceleration for specific options regarding graphics acceleration.
