Qt para Windows - Creación desde el código fuente
Esta página describe el proceso de configuración y construcción de Qt para Windows. Para descargar e instalar un Qt precompilado para Windows, siga las instrucciones de la página Primeros pasos con Qt.
Paso 1: Obtener los fuentes
Las fuentes de Qt pueden instalarse en Qt Online Installer. Los paquetes de fuentes también están disponibles a través de Git, como archivos en la Cuenta Qt (usuarios comerciales), y en download.qt.io (usuarios de código abierto).
Si instalas los fuentes a través de Qt Online Installer, estarán disponibles en el directorio de instalación de Qt, por ejemplo C:\Qt\6.11.0\Src.
Si ha descargado el archivo fuente, extráigalo a un directorio de su elección, por ejemplo C:\dev\Qt\src.
Nota: La ruta al directorio de fuentes no debe contener espacios ni caracteres específicos del sistema de archivos de Windows. La ruta también debe ser corta. De este modo se evitan problemas con rutas de archivo demasiado largas en la fase de compilación.
Paso 2: Instalación de los requisitos de compilación y configuración del entorno
Para compilar Qt a partir de los fuentes se necesita un entorno de compilación con un compilador compatible y varias herramientas de compilación.
Herramientas de compilación
| Herramienta | Versiones soportadas | Descripción |
|---|---|---|
| CMake | Versión 3.22 y posteriores. | Necesario para configurar la compilación de Qt. Disponible en Qt Online Installer y en cmake.org. |
| Ninja | - | Herramienta recomendada para compilar Qt. Disponible en Qt Online Installer y en ninja-build.org. |
| Python | Versión 3 | Herramienta de compilación necesaria. Los instaladores para Windows están disponibles en python.org, o en Microsoft Store. |
Los ejecutables cmake.exe, ninja.exe, y python.exe deben estar disponibles en su entorno de compilación. Añada el directorio correspondiente a su variable de entorno PATH.
Compiladores
Los siguientes compiladores y configuraciones son compatibles con Qt 6.11:
| Sistema operativo | Arquitectura | Compilador | Notas |
|---|---|---|---|
| Windows 10 (1809 o posterior) | x86_64 | MSVC 2022, Mingw-w64 13.1 | |
| Windows 11 | x86_64 | MSVC 2022, Mingw-w64 13.1 | |
| Windows en ARM | ARM64 | MSVC 2022 |
Nota: Actualmente Qt no soporta ARM64EC en Windows en dispositivos ARM.
Nota: Para MSVC 2022, debe seleccionarse Windows SDK versión 10.0.17763 o posterior en el instalador de Visual Studio.
Dependencias de QDoc
QDoc utiliza Clang para analizar el código C++. Si desea compilar QDoc manualmente, consulte Instalación de Clang para QDoc para conocer los requisitos de compilación específicos.
Qt GRPC y Qt Protobuf Dependencias
Qt GRPC y Qt Protobuf requieren la instalación de los paquetes gRPC y Protobuf. Puedes encontrar las instrucciones de instalación de los paquetes en el Ejemplo de instalación para Windows usando vcpkg.
Configuración del entorno
Para MSVC, realice una de las siguientes acciones:
- Ejecute el archivo vcvarsall.bat:
"C:\Program Files\Microsoft Visual Studio\2022\Professional\VC\Auxiliary\Build\vcvarsall.bat" amd64
- Busque en la barra de búsqueda de Windows el símbolo del sistema VS Native Tools.
Para Mingw-w64: Añada Mingw-w64 a la variable de entorno PATH:
Set PATH=C:\qt\tools\mingw1120_64\bin;%PATH%
Paso 3: Construir las librerías y herramientas Qt
Para configurar la compilación, cree un directorio de compilación y ejecute el script configure.bat en este directorio:
mkdir C:\dev\qt-build cd C:\dev\qt-build C:\dev\Qt\src\configure.bat
Por defecto, Qt está configurado para instalarse en el directorio C:\Qt\Qt-major.minor.patch, donde la tripleta major.minor.patch representa la versión de Qt que se está construyendo. Esto puede cambiarse utilizando la opción -prefix. Vea la lista de Opciones de Configuración de Qt para hacer más ajustes.
Luego construye las librerías y herramientas:
cmake --build . --parallel # or ninja
El punto después de --build significa la carpeta actual.
Después de la construcción, es necesario instalar las bibliotecas y herramientas en la ruta deseada (a menos que haya activado un desarrollador construir):
cmake --install . # or ninja install
Nota: Para CMake versión < 4.0. El comando cmake --install . instala sólo las versiones de lanzamiento de las librerías y herramientas incluso si construyes tanto librerías de depuración como de lanzamiento. Para instalar tanto la versión de depuración como la de lanzamiento, utilice ninja install. También puede ejecutar los comandos cmake --install . --config Debug y cmake --install . --config Release.
Paso 4: Construir su aplicación
Una vez instalado Qt, puede empezar a crear aplicaciones con él.
Si trabaja desde la línea de comandos, considere añadir las herramientas Qt a su variable de entorno PATH como se indica a continuación:
set PATH=C:\Qt\Qt-major.minor.patch\bin;%PATH%
Si planeas usar Qt desde un IDE, necesitas registrar la versión de Qt explícitamente allí. Para Qt Creator, ver Qt Creator: Añadir versiones de Qt.
© 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.