Qt für Windows – Kompilieren aus dem Quellcode
Auf dieser Seite wird beschrieben, wie Sie Qt für Windows konfigurieren und kompilieren. Um eine vorgefertigte Qt-Version für Windows herunterzuladen und zu installieren, befolgen Sie die Anweisungen auf der Seite „Erste Schritte mit Qt “.
Schritt 1: Beschaffung der Quellcodes
Die Qt-Quellcodes können unter Qt Online Installer installiert werden. Quellcode-Pakete sind außerdem über Git, als Archive im Qt-Konto (kommerzielle Nutzer) und auf download.qt.io (Open-Source-Nutzer) verfügbar.
Wenn Sie die Quellcodes über Qt Online Installer installieren, stehen sie im Qt-Installationsverzeichnis zur Verfügung, zum Beispiel C:\Qt\6.12.0\Src.
Wenn Sie das Quellarchiv heruntergeladen haben, entpacken Sie es in ein Verzeichnis Ihrer Wahl, zum Beispiel C:\dev\Qt\src.
Hinweis: Der Pfad zum Quellverzeichnis darf keine Leerzeichen oder Windows-spezifische Dateisystemzeichen enthalten. Der Pfad sollte außerdem kurz gehalten werden. Dies verhindert Probleme mit zu langen Dateipfaden in der Kompilierungsphase.
Schritt 2: Installieren der Build-Voraussetzungen und Einrichten der Umgebung
Um Qt aus dem Quellcode zu erstellen, benötigen Sie eine Entwicklungsumgebung mit einem unterstützten Compiler und verschiedenen Entwicklungswerkzeugen.
Build-Tools
| Tool | Unterstützte Versionen | Beschreibung |
|---|---|---|
| CMake | Version 3.25 und höher. | Erforderlich für die Konfiguration des Qt-Builds. Verfügbar unter Qt Online Installer und auf cmake.org. |
| Ninja | - | Empfohlene Tool zum Erstellen von Qt. Verfügbar unter Qt Online Installer und auf ninja-build.org. |
| Python | Version 3 | Erforderliches Build-Tool. Windows-Installationsprogramme sind auf python.org oder im Microsoft Store erhältlich. |
Die ausführbaren Dateien cmake.exe, ninja.exe und python.exe müssen in Ihrer Build-Umgebung verfügbar sein. Fügen Sie das jeweilige Verzeichnis Ihrer Umgebungsvariablen ` PATH ` hinzu.
Compiler
Die folgenden Compiler und Konfigurationen werden in Qt 6.12 unterstützt:
| Betriebssystem | Architektur | Compiler | Hinweise |
|---|---|---|---|
| Windows 10 (1809 oder höher) | x86_64 | MSVC 2022, Mingw-w64 15.1 | |
| Windows 11 | x86_64 | MSVC 2022, Mingw-w64 15.1 | |
| Windows auf ARM | ARM64 | MSVC 2022 | |
| Windows auf ARM | ARM64EC | MSVC 2026 | Keine Installationspakete. WebViewEs fehlt die Unterstützung für einige Qt-Module (Qt XML-ph-0000@deepl.internal, Qt WebEngine und Qt Quick 3D -Physik). |
Hinweis: Qt 6.12 wird die letzte Version sein, die Windows 10 unterstützt.
Hinweis: Für MSVC 2022 muss im Visual Studio-Installationsprogramm die Windows SDK-Version 10.0.17763 oder höher ausgewählt werden.
QDoc-Abhängigkeiten
QDoc verwendet Clang zum Parsen von C++-Code. Wenn Sie QDoc manuell kompilieren möchten, finden Sie unter „Installation von Clang für QDoc“ die spezifischen Kompilierungsanforderungen.
Qt GRPC sowie Abhängigkeiten von „ Qt Protobuf “
Qt GRPC und Qt Protobuf erfordern die Installation der Pakete „ gRPC “ und „ Protobuf “. Die Installationsanweisungen für die Pakete finden Sie im Abschnitt „Beispiel für die Installation unter Windows mit vcpkg“.
Einrichten der Umgebung
Für MSVC führen Sie einen der folgenden Schritte aus:
- Führen Sie die Datei „vcvarsall.bat“ aus:
"C:\Program Files\Microsoft Visual Studio\2022\Professional\VC\Auxiliary\Build\vcvarsall.bat" amd64 - Suchen Sie in der Windows-Suchleiste nach der Eingabeaufforderung „VS Native Tools“.
Für Mingw-w64: Fügen Sie „Mingw-w64“ zur Umgebungsvariable „ PATH “ hinzu:
Set PATH=C:\qt\tools\mingw1120_64\bin;%PATH%Schritt 3: Erstellen der Qt-Bibliotheken und -Tools
Um Ihren Build zu konfigurieren, erstellen Sie ein Build-Verzeichnis und führen Sie in diesem Verzeichnis das Skript „ configure.bat “ aus:
mkdir C:\dev\qt-build
cd C:\dev\qt-build
C:\dev\Qt\src\configure.batStandardmäßig ist Qt für die Installation im Verzeichnis „ C:\Qt\Qt-major.minor.patch “ konfiguriert, wobei das Triplett „major.minor.patch“ die zu kompilierende Qt-Version angibt. Dies kann mithilfe der Option „ -prefix “ geändert werden. Weitere Anpassungen finden Sie in der Liste der Qt-Konfigurationsoptionen.
Erstellen Sie anschließend die Bibliotheken und Werkzeuge:
cmake --build . --parallel
# or
ninjaEin Punkt nach „ --build “ bedeutet den aktuellen Ordner.
Nach dem Erstellen müssen Sie die Bibliotheken und Werkzeuge im gewünschten Pfad installieren (es sei denn, Sie haben einen Entwickler-Build aktiviert):
cmake --install .
# or
ninja installHinweis: Für CMake-Versionen < 4.0: Der Befehl „ cmake --install . “ installiert nur die Release-Versionen der Bibliotheken und Werkzeuge, selbst wenn Sie sowohl Debug- als auch Release-Bibliotheken erstellen. Um sowohl die Debug- als auch die Release-Bibliotheken zu installieren, verwenden Sie „ ninja install “. Sie können auch die Befehle „ cmake --install . --config Debug “ und „ cmake --install . --config Release “ ausführen.
Schritt 4: Erstellen Ihrer Anwendung
Nachdem Qt installiert ist, können Sie damit beginnen, Anwendungen zu erstellen.
Wenn Sie über die Befehlszeile arbeiten, sollten Sie die Qt-Tools wie folgt zur Umgebungsvariablen „ PATH “ hinzufügen:
set PATH=C:\Qt\Qt-major.minor.patch\bin;%PATH%Wenn Sie Ihre Anwendung über eine IDE erstellen möchten, müssen Sie die Qt-Version dort explizit registrieren:
- Für „ Qt Creator “ siehe Qt Creator: Qt-Versionen hinzufügen.
- Für „ Qt Extension for Visual Studio Code “ siehe Qt Extension for Visual Studio Code: Qt-Installationen registrieren.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.